Erstellen eines VXC zwischen einem Port und Microsoft Azure mithilfe der API
Dieses Thema führt Sie schrittweise durch das API-Verfahren zur Erstellung eines VXC von einem Port zu Microsoft Azure ExpressRoute, einschließlich der Suche nach Azure-Portstandorten und der Reihenfolge der VXCs.
Der Port für die Azure-Bereitstellung ermöglicht folgende Aufgaben:
-
Richten Sie eine ExpressRoute-Leitung in der Azure-Konsole ein.
Nach der Bereitstellung erhalten Sie einen Dienstschlüssel. Der Dienstschlüssel ist mit den zugewiesenen Ports in Azure verknüpft. Wenn Sie einen Dienstschlüssel validieren, zeigt die Antwort die zugewiesenen primären und sekundären Ports in Azure an. Sie können den Dienstschlüssel zweimal verwenden: einmal für die Verbindung mit dem primären Port und ein zweites Mal, um eine weitere Verbindung mit dem sekundären Port herzustellen.
Weitere Informationen dazu finden Sie in der Microsoft-Hilfe unter Schnellstart: Erstellen und Ändern einer ExpressRoute-Leitung. -
Mit dem Dienstschlüssel können Sie Ihre VXCs im Megaport Portal erstellen und bereitstellen.
In diesem Schritt wird die API verwendet – die anderen Schritte werden außerhalb von Megaport in der Azure-Umgebung ausgeführt. -
Wenn ein VXC für Ihre Leitung bereitgestellt wurde, konfigurieren Sie Peering im Azure-Portal.
Die Peering-Informationen werden von den primären und sekundären Leitungen gemeinsam genutzt, ebenso wie das dem Peer zugewiesene innere VLAN.
Details finden Sie in der Microsoft-Hilfe Erstellen und Ändern des Peerings für eine ExpressRoute Verbindung mithilfe des Azure-Portals. -
Konfigurieren Sie das CPE-Gerät (Kundenendgerät).
Bevor Sie beginnen, besorgen Sie sich ein gültiges Access Token. Weitere Informationen dazu finden Sie unter Erstellen eines API-Schlüssels.
Dienstschlüssel validieren
Wenn Sie die API verwenden, um einen Azure-Dienstschlüssel zu validieren, enthält die Antwort ExpressRoute-Details zu den zugehörigen Ports und Peers. Sie benötigen die Portangaben, um die VXCs zu erstellen.
So validieren Sie den Dienstschlüssel in der Postman-Sammlung
-
Erweitern Sie in Postman im linken Navigationsbereich Cloud Connectivity > Port > Azure (Cloudkonnektivität > Port > Azure), und wählen Sie GET Look Up Azure Service Key (Azure-Dienstschlüssel suchen) aus.
-
Fügen Sie den Dienstschlüssel zum Endpunkt hinzu.
-
Klicken Sie auf Send (Senden), um eine GET-Anfrage an den API-Server zu stellen.
GET {baseUrl}/v2/secure/azure/{service_key}
Dies 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 bedeutet, dass sie für neue VXCs verfügbar sind.
Weitere Informationen zu den einzelnen Antwortfeldern finden Sie unter Antwortfelder der Azure-Dienstschlüssel-API.
Erstellen der VXCs
Erstellen Sie mit den Angaben aus dem Dienstschlüssel einen VXC für den primären Port und einen weiteren VXC für den sekundären Port.
So erstellen Sie die VXCs
-
Wählen POST Create VXC to Azure (VXC zu Azure erstellen) aus.
Tipp
Um Ihre Anfrage vor der Bestellung zu testen und Preisdetails zu sehen, können Sie folgenden Befehl verwenden: POST {API Server URL}/v2/networkdesign/validate
-
Aktualisieren Sie den Body der Anfrage mit der
productUiddes Ports, dem Namen des VXC, derproductUiddes primären Azure-Ports und dem Dienstschlüssel. Die maximale Geschwindigkeit (rateLimit) wird im Bandbreitenwert der Dienstschlüsselantwort definiert. In diesem Fall ist es 200. -
Klicken Sie auf Send (Senden), um die Anfrage zu senden.
POST {baseUrl}/v2/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"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 für die Azure-Ports konfiguriert haben, zeigt eine weitere Dienstschlüsselsuche die mit den Azure-Ports verbundenen VXCs an. Die VXCs werden durch eine ID-Nummer (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 das Peering im Azure-Portal und Ihre CPE-Geräte.