Erstellen einer VXC zu AWS mit der API
In diesem Thema wird das API-Verfahren zum Erstellen einer VXC von einem Port zu AWS beschrieben, einschließlich des Nachschlagens von Cloud-Interconnect-Standorten, der Validierung der Verbindung und der Bestellung der VXC.
Das Beispiel in diesem Thema erstellt eine Hosted-VIF-Verbindung zu AWS mit einer Datenrate von 500 Mbit/s. Um dieses Beispiel Schritt für Schritt durchzugehen, verwenden Sie die URL der Staging-Umgebung, mit der Sie die Verbindungen konfigurieren können, die Dienste jedoch weder bereitstellen noch berechnen.
Bevor Sie beginnen, beschaffen Sie sich ein gültiges Access Token. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.
Tipp
Um alle Optionen für die in diesem Beispiel verwendeten Requests zu sehen, siehe https://dev.megaport.com.
AWS-Port-Standortdetails nachschlagen
Um eine VXC zu AWS zu erstellen, benötigen Sie die AWS-Portdetails. Verwenden Sie die API, um die Interfaces abzurufen, die Megaport mit Cloud Service Providern hat, um die erforderlichen AWS-Portdetails zu identifizieren.
So suchen Sie AWS-Port-Standortdetails in der Postman-Collection nach
-
Erweitern Sie den Ordner Locations in der linken Navigation und klicken Sie auf GET Partner Megaports.
-
Klicken Sie auf Send, um eine GET-Anfrage an den API-Server zu senden.
GET {baseUrl}/v2/dropdowns/partner/megaportsDiese Anfrage liefert alle Interfaces, die Megaport mit Cloud Service Providern hat. Sie können suchen, indem Sie auf die Lupe klicken und einen Standort, ein Rechenzentrum oder einen anderen Parameter in das Suchfeld eingeben.
Der connectType gibt den Cloud Service Provider an. Für AWS umfasst er “AWS” für Hosted VIFs und “AWSHC” für Hosted Connections.
Sie können die Ergebnisse nach
connectTypeundvxcPermittedfiltern.GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueDieses Beispiel verwendet einen Port in Interxion DUB2, der VXCs akzeptiert (
“vxcPermitted”: true) und sich in der Region eu-west-1 befindet.
{
"connectType": "AWS",
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"vxcPermitted": true,
"companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
"companyName": "AWS",
"title": "EU (Ireland) (eu-west-1)",
"locationId": 96,
"speed": 10000,
"rank": 61,
"lag_id": 2,
"lag_primary": true,
"aggregation_id": 54188
},
Erstellen und Bereitstellen eines VXC
Mit den AWS-Port-Details aus der GET Partner Megaports-API können Sie die Verbindung validieren und anschließend ein VXC erstellen.
So testen und validieren Sie die Bestellung
-
In Postman erweitern Sie Cloud-Konnektivität > Port > AWS Direct Connect in der linken Navigation und wählen POST Validierung AWS - Hosted VIF (v3) aus.
-
Aktualisieren Sie den Body der Anfrage mit der
productUiddes Ports, derproductUiddes AWS-Ports und der AWS-Konto-ID.
Sie können auch zusätzliche Werte wie Name, Datenbeschränkung, Vertragslaufzeit, VLAN-ID, ASN-Werte, Authentifizierungsschlüssel und IP-Adressierung ändern. -
Klicken Sie auf Senden, um die POST-Anfrage abzuschicken.
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 777
},
"bEnd": {
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"partnerConfig": {
"connectType": "AWS",
"name": "Amazon name for service",
"type": "private",
"asn": 65105,
"amazonAsn": 64555,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Nach erfolgreicher Validierung können Sie die Bestellung des VXC aufgeben.
So erstellen Sie ein VXC
-
Kopieren Sie den validierten Body von POST Validierung AWS - Hosted VIF (v3) und fügen Sie ihn in den Body von POST Kauf AWS - Hosted VIF (v3) ein.
-
Klicken Sie auf Send um die Anfrage zu posten.
POST {baseUrl}/v3/networkdesign/buy
Im Folgenden ein Beispiel für eine erfolgreiche Antwort.
{
"message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] created. ",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1588868593704,
"vxcOrderId": 42328,
"payerMegaPortId": 68124,
"nonPayerMegaPortId": 52786,
"payerMegaPortName": "API Port",
"nonPayerMegaPortName": "EU (Ireland) (eu-west-1)",
"payerCompanyId": 2278,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 96,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 138231,
"nonPayerMegaPortNsId": 221182,
"payerVlanId": 777,
"nonPayerVlanId": 0,
"payerApproverName": "Paul McGuinness",
"payerApproverId": 12695,
"nonPayerApproverName": "Paul McGuinness",
"nonPayerApproverId": 12684,
"payerApproval": 1582268553574,
"nonPayerApproval": 1228868693614,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from API Port to EU (Ireland) (eu-west-1)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 500,
"distanceBand": "ZONE",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 57115,
"vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
"provisionDate": 1588868593517,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": {
"type": "private",
"asn": 65105,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"customerIpAddress": null,
"amazonIpAddress": null,
"prefixes": "10.0.1.0/24",
"name": "Amazon name for service"
},
"amsixConnectConfigDto": null,
"webAirProvItem": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_LONG_HAUL_VXC",
"costCentre": null,
"azureServiceKey": null,
"oracleVirtualCircuitId": null,
"serviceKey": null,
"connectType": "AWS",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"fullyApproved": true
}
]
}
Der Port und VXC erscheinen jetzt im Megaport Portal.
In diesem Beispiel erscheint die AWS Hosted VIF im AWS-Portal-Konto unter Direct Connect - Virtual Interfaces. Der Kontoinhaber kann die Virtual Interface akzeptieren und sie mit einem Virtual Private Gateway oder einem Direct Connect Gateway verbinden und anschließend mit seinen VPCs.
- AWS stellt in der AWS‑Dokumentation detaillierte Schritte zum Erstellen von Public‑, Private‑ und Transit‑Schnittstellen bereit.