Erstellen eines VXC zwischen einem Port und Microsoft Azure mit der API
In diesem Thema wird das API-Verfahren beschrieben, um einen VXC von einem Port zu Microsoft Azure ExpressRoute zu erstellen, einschließlich der Suche nach Azure-Port-Standorten und der Bestellung der VXCs.
Die Bereitstellung von Port zu Azure umfasst diese Aufgaben:
-
Einen ExpressRoute-Circuit in der Azure-Konsole einrichten
Nach der Bereitstellung erhalten Sie einen Service-Schlüssel. Der Service-Schlüssel ist mit den zugewiesenen Ports in Azure verknüpft. Wenn Sie einen Service-Schlüssel validieren, zeigt die Antwort die in Azure zugewiesenen primären und sekundären Ports an. Sie können den Service-Schlüssel zweimal verwenden – einmal, um eine Verbindung zum primären und ein zweites Mal, um eine weitere Verbindung zum sekundären Port herzustellen.
Weitere Informationen finden Sie im Microsoft-Hilfethema Tutorial: Erstellen und Ändern eines ExpressRoute-Circuits. -
Mit dem Service-Schlüssel Ihre VXCs über das Megaport Portal erstellen und bereitstellen
Dieser Schritt verwendet die API – die anderen Schritte erfolgen außerhalb von Megaport in der Azure-Umgebung.
-
Mit einem für Ihren Circuit bereitgestellten VXC konfigurieren Sie Peering im Azure-Portal
Peering-Informationen werden zwischen den primären und sekundären Circuits gemeinsam genutzt, ebenso das dem Peer zugewiesene innere VLAN.
Weitere Informationen finden Sie im Microsoft-Hilfethema Peering für einen ExpressRoute-Circuit erstellen und ändern. -
Customer Premises Equipment (CPE)-Gerät konfigurieren
Bevor Sie beginnen, beschaffen Sie sich ein gültiges Zugriffstoken. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.
Service-Schlüssel validieren
Wenn Sie die API verwenden, um einen Azure-Service-Schlüssel zu validieren, enthält die Antwort ExpressRoute-Details der zugehörigen Ports und Peers. Sie benötigen die Port-Details, um die VXCs zu erstellen.
So validieren Sie den Service-Schlüssel in der Postman-Sammlung
-
In Postman erweitern Sie Cloud-Konnektivität > Port > Azure in der linken Navigation und wählen Sie GET Azure-Service-Schlüssel nachschlagen.
-
Fügen Sie den Service-Schlüssel zum Endpunkt hinzu.
-
Klicken Sie auf Senden, um eine GET-Anfrage an den API-Server zu stellen.
GET {baseUrl}/v2/secure/azure/{service_key}
Hier ist eine Beispielantwort für einen neuen Schlüssel (ohne konfigurierte VXCs):
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Der Wert megaports:vxc ist für beide Ports null, was darauf hinweist, dass sie für neue VXCs verfügbar sind.
Erstellen und Bereitstellen der VXCs
Mit den Informationen aus dem Service-Key erstellen Sie ein VXC zum primären Port und ein weiteres zum sekundären Port.
So erstellen Sie die VXC
-
Wählen Sie POST Create VXC to Azure (v3) aus.
Tipp
Um Ihre Anfrage vor der Bestellung zu testen und Preisinformationen zu sehen, können Sie den Endpunkt verwenden: POST {baseUrl}/v3/networkdesign/validate
-
Aktualisieren Sie den Body der Anfrage mit der
productUiddes Ports, dem Namen der VXC, derproductUiddes primären Azure-Ports und dem Service-Schlüssel. Die maximale Geschwindigkeit (rateLimit) ist im Bandbreitenwert der Service-Key-Antwort definiert. In diesem Fall sind es 200. -
Klicken Sie auf Senden, um die Anfrage zu senden.
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A-End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term":12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID from the Azure service key lookup
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //service key from lookup response
}
}
}
]
}
]
Wenn Sie Ihre primären und sekundären VXCs zu den Azure-Ports konfiguriert haben, zeigt eine erneute Service-Key-Abfrage die mit den Azure-Ports verknüpften VXCs. Die VXCs werden durch eine ID (megaports:vxc) identifiziert.
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60621,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60622,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Um die Konfiguration abzuschließen, konfigurieren Sie Peering im Azure-Portal und konfigurieren Sie Ihre CPE-Geräte.