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:

  1. 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 finden Sie im Microsoft-Hilfethema Schnellstart: Erstellen und Ändern einer ExpressRoute-Leitung.

  2. Mit dem Dienstschlüssel können Sie Ihre VXCs über das Megaport Portal erstellen und bereitstellen.

    Dieser Schritt verwendet die API – die anderen Schritte liegen außerhalb von Megaport in der Azure-Umgebung.

  3. 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 im Microsoft-Hilfethema Erstellen und Ändern des Peerings für eine ExpressRoute-Leitung mithilfe des Azure-Portals.

  4. Konfigurieren Sie das CPE-Gerät (Customer Premises Equipment).

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.

    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.

Verwenden Sie diesen Endpunkt, um den VXC zu bestellen.

POST {baseUrl}/v2/networkdesign/buy

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 productUid des Ports, dem Namen des VXC, der productUid des 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.

[
    {
        "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 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.


Letztes Update: