action.skip

Erstellen eines VXC zwischen einem Port und Google Cloud mit der API

Dieses Thema beschreibt das API-Verfahren zum Erstellen eines VXC von einem Port zu Google Cloud, einschließlich der Suche nach Google Cloud Port-Standorten und der Bestellung des VXC.

Bevor Sie beginnen, beschaffen Sie ein gültiges Zugriffstoken. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.

Google Pairing-Schlüssel nachschlagen

Für eine Verbindung zwischen einem Port und Google Cloud ist ein Pairing-Schlüssel erforderlich. Diesen Schlüssel erhalten Sie im Google Cloud-Portal. Über die API validieren Sie einen Google Cloud Pairing-Schlüssel, und die Antwort enthält Details zu den zugehörigen Ports und Peers. Sie benötigen die Port-Details, um den VXC zu erstellen.

So schlagen Sie den Pairing-Schlüssel in der Postman-Collection nach

  1. Klappen Sie in Postman im linken Navigationsbereich Cloud Connectivity > Port > Google Cloud auf und wählen Sie GET Look Up Google Pairing Key aus.

  2. Fügen Sie den Pairing-Schlüssel dem Endpunkt hinzu.

  3. Klicken Sie auf Senden, um eine GET-Anfrage an den API-Server zu senden.

    GET {baseUrl}/v2/secure/google/{pairing_key}
    

Hier ist eine Beispielantwort für einen Pairing-Schlüssel, bei dem der erste VXC konfiguriert ist, der zweite VXC jedoch verfügbar ist (vxc = null):

{
   "message": "Successful lookup",
    "data": {
        "bandwidths": [
        50,
        100,
        200,
        300,
        400,
        500,
        1000,
        2000,
        5000,
        10000
        ],
        "megaports": [
        {
            "port": 13687,
            "vxc": {
                // existing vxc object
            },
            "productId": 13687,
            "productUid": "2c9337ba-b6a6-44cc-851c-58315060a0e3",
            "name": "New York (lga-zone2-1422)",
            "nServiceId": 30890,
            "description": "Google Inc at Digital Realty NYC1",
            "companyId": 90,
            "companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
            "companyName": "Google Inc",
            "portSpeed": 10000,
            "locationId": 62,
            "state": "NY",
            "country": "USA"
        },
        {
            "port": 12515,
            "vxc": null,
            "productId": 12515,
            "productUid": "2fa8c6c5-314f-4d14-8fb6-e1f7f86bdacc",
            "name": "Ashburn (iad-zone2-1)",
            "nServiceId": 28349,
            "description": "Google Inc at zColo 21635 Red Rum Drive",
            "companyId": 90,
            "companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
            "companyName": "Google Inc",
            "portSpeed": 10000,
            "locationId": 84,
            "state": "VA",
            "country": "USA"
        }
        ],
        "resource_type": "csp_connection"
    }
}

Erstellen und Bereitstellen eines VXC

Mit den Informationen aus dem Pairing-Key erstellen Sie ein VXC zum verfügbaren Port.

So erstellen Sie ein VXC

  1. Wählen Sie POST Create VXC to Google Cloud (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

  2. Aktualisieren Sie den Body der Anfrage mit der productUid des Ports, dem Namen des VXC, der productUid des Google Cloud-Ports und dem Pairing-Schlüssel. Die Bandbreitenoptionen sind in der Liste enthalten, die mit dem Pairing-Schlüssel zurückgegeben wird, und Sie müssen eine vordefinierte Bandbreite verwenden.

  3. Klicken Sie auf Senden, um die Anfrage zu senden.

    POST {baseUrl}/v3/networkdesign/buy
    
[
    {
        "productUid": "d5f4a3c6-06d3-4cfa-9d4e-8ce6ec0b6dbd", //UID of your Megaport (A-End)
        "associatedVxcs": [
            {
                "rateLimit": 100, // from list of supported bandwidths in key lookup
                "term":12,
                "shutdown": false,
                "promoCode": "promox3mnthfree2",
                "productName": "Example Google VXC",
                "aEnd": {
                    "vlan": 90,
                },
                "bEnd": {
                    "productUid": "7bab4547-ff88-43f9-a1de-3df637522fa5", // port UID from pairing key lookup
                    "partnerConfig": {
                        "connectType": "GOOGLE",
                        "pairingKey": "fbbf41b1-9513-4837-a91a-22a8bb065704/us-west1/2"
                    }
                },
                "productType": "VXC"
            }
        ]
    }
]

Sobald Sie den VXC erstellt und bereitgestellt haben, gehen Sie zurück zur Google Cloud Console und akzeptieren Sie das Attachment. Von Google erhalten Sie Ihre private IP-Adresse zur Konfiguration von BGP.

Damit ist Ihre Layer-2-VXC-Bereitstellung abgeschlossen.