Erstellen eines VXC zwischen einem MVE und Google Cloud mit der API
Dieses Thema beschreibt das API-Verfahren zum Erstellen eines VXC von einem MVE zu Google Cloud Services. Die Konfiguration erfolgt in zwei Schritten: Zuerst rufen Sie mit dem Google pairing key die Verbindungsdetails ab, dann erstellen Sie den VXC zu einer bestimmten vNIC auf Ihrem MVE.
Hinweis
Bevor Sie eine Verbindung zu Google Cloud herstellen können, müssen Sie in der Google Cloud Console oder mit der gcloud CLI einen Partner Interconnect VLAN-Anhang erstellen. Im Rahmen der Erstellung des Anhangs erhalten Sie einen pairing key, der die Google-Verbindungsdetails enthält.
Die Bereitstellung von MVE zu Google Cloud umfasst folgende Aufgaben:
-
Einen Partner Interconnect VLAN-Anhang in der Google Cloud Console oder mit der gcloud CLI erstellen
Erstellen Sie einen Partner Interconnect VLAN-Anhang in der Google Cloud Console oder mit der gcloud CLI. Kopieren Sie den pairing key, der im Zuge der Erstellung des Anhangs bereitgestellt wird. Weitere Details finden Sie in der Google-Dokumentation zu Google Partner Interconnects.
-
Den Google pairing key validieren
Wenn Sie einen Google Cloud-Service bestellen, verwenden Sie den pairing key und stellen Sie sicher, dass ein freier Port für eine Verbindung verfügbar ist.
Google verlangt, dass die Bandbreite des VXC einer der vordefinierten Bandbreiten in der Liste entspricht, die beim Nachschlagen des pairing key zurückgegeben wird.
-
Einen VXC erstellen und bereitstellen
Mit dem validierten pairing key und den Port-Details erstellen Sie den VXC von dem MVE zu Google Cloud.
Die Konfigurationsdetails werden im Body der Anforderung angegeben.
Bevor Sie beginnen, besorgen Sie sich ein gültiges Access Token. Weitere Informationen finden Sie unter Erstellen eines API-Schlüssels.
Den Google pairing key validieren
Verwenden Sie die API, um einen Google Cloud pairing key zu validieren. Die Antwort enthält Details zu den zugeordneten Ports und Peers. Sie benötigen die Port-Details, um den VXC zu erstellen.
In der API-Antwort werden verfügbare Ports als "vxc":null aufgeführt und Ports mit einem zugewiesenen Wert sind nicht verfügbar.
Google verlangt, dass die Bandbreite des VXC einer der vordefinierten Bandbreiten in der Liste entspricht, die beim Nachschlagen des pairing key zurückgegeben wird.
So validieren Sie den pairing key
-
Verwenden Sie die GET Look Up Google Pairing Key API, um mit dem pairing key Details zum Google Cloud-Standort nachzuschlagen:
GET {baseUrl}/v2/secure/google/{pairing_key}
Hier ist eine Beispielantwort für einen pairing key mit einem verfügbaren Port (vxc = null).
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"bandwidths": [
50,
100,
200,
300,
400,
500,
1000,
2000,
5000,
10000,
20000,
50000
],
"megaports": [
{
"productId": 28845,
"productUid": "5b693428-8cc6-4634-a44a-2e9e6ba556af",
"name": "Stockholm (arn-zone1-208)",
"nServiceId": 65391,
"description": "Google inc.. at Interxion STO5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 98,
"state": null,
"country": "Sweden",
"port": 28845,
"vxc": null
},
{
"productId": 45873,
"productUid": "832a017d-74ca-45e8-a225-e3d794a079d7",
"name": "Zurich (zrh-zone1-81)",
"nServiceId": 103010,
"description": "Google inc.. at Interxion ZH1",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 557,
"state": null,
"country": "Switzerland",
"port": 45873,
"vxc": null
},
{
"productId": 81531,
"productUid": "6e587057-f012-4600-896f-9ee171fdd444",
"name": "Frankfurt (fra-zone1-683)",
"nServiceId": 181786,
"description": "Google inc.. at Equinix FR5",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 131,
"state": null,
"country": "Germany",
"port": 81531,
"vxc": null
},
{
"productId": 84769,
"productUid": "f25e581b-3c0e-4069-8147-78cce082357e",
"name": "Amsterdam (ams-zone1-1236)",
"nServiceId": 188925,
"description": "Google inc.. at Equinix AM1",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 85,
"state": null,
"country": "Netherlands",
"port": 84769,
"vxc": null
},
{
"productId": 95335,
"productUid": "9fde43f5-2f00-41ed-bb60-45c446ea43df",
"name": "London (lhr-zone1-832)",
"nServiceId": 217347,
"description": "Google inc.. at Equinix LD5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 90,
"state": null,
"country": "United Kingdom",
"port": 95335,
"vxc": null
},
{
"productId": 153623,
"productUid": "ae8d21b5-2db6-4f72-a465-624c914f4918",
"name": "Paris (cdg-zone1-1536)",
"nServiceId": 391882,
"description": "Google inc.. at Interxion PAR5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 527,
"state": null,
"country": "France",
"port": 153623,
"vxc": null
},
{
"productId": 162678,
"productUid": "7d1cca03-eb3d-4be4-a145-de8e8dffec3f",
"name": "Frankfurt (fra-zone1-58)",
"nServiceId": 420550,
"description": "Google inc.. at Interxion FRA6",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 130,
"state": null,
"country": "Germany",
"port": 162678,
"vxc": null
}
],
"resource_type": "csp_connection",
"ports": [
{
"service_id": 38286,
"vxc_service_ids": []
},
{
"service_id": 65391,
"vxc_service_ids": []
},
{
"service_id": 103010,
"vxc_service_ids": []
},
{
"service_id": 125905,
"vxc_service_ids": []
},
{
"service_id": 154694,
"vxc_service_ids": []
},
{
"service_id": 181786,
"vxc_service_ids": []
},
{
"service_id": 188925,
"vxc_service_ids": []
},
{
"service_id": 217347,
"vxc_service_ids": []
},
{
"service_id": 391882,
"vxc_service_ids": []
},
{
"service_id": 420550,
"vxc_service_ids": []
}
]
}
}
Erstellen und Bereitstellen eines VXC zu einer bestimmten vNIC
Mit dem validierten Pairing-Key und den Port-Details erstellen Sie das VXC vom MVE zu Google Cloud.
Sie geben die Konfigurationsdetails im Body der Anfrage an. Die erste productUididentifiziert die MVE ID und die bEnd: productUid identifiziert den Google Cloud-Standort aus dem Pairing-Key. Sie müssen auch Ihren Google-Pairing-Key in der Anfrage angeben. Nur die innere VLAN-ID von aEnd muss angegeben werden.
Tipp
Um Ihre Anfrage vor der Bestellung zu testen und Preisinformationen zu sehen, verwenden Sie den Endpunkt /v3/networkdesign/validate mit derselben Body-Konfiguration.
So erstellen Sie ein VXC
-
Erstellen Sie eine Anfrage mit dem POST Create VXC to Google Cloud (v3) Endpunkt:
POST {baseUrl}/v3/networkdesign/buy -
Aktualisieren Sie den Body der Anfrage mit der
productUiddes MVE, dem Namen des VXC, derproductUiddes Google Cloud-Ports, setzen Sie denvNicIndexauf 2 (Schnittstelle 3) und den Pairing-Key.Hinweis
Die vNIC-Nummer entspricht den folgenden MVE Schnittstellen:
- vNIC 0 = Schnittstelle 1 auf dem MVE
- vNIC 1 = Schnittstelle 2 auf dem MVE
- vNIC 2 = Schnittstelle 3 auf dem MVE
- vNIC 3 = Schnittstelle 4 auf dem MVE
- vNIC 4 = Schnittstelle 5 auf dem MVE
Hier ist eine Beispielanforderung:
[
{
"productUid": "{{ mveid }}",
"associatedVxcs": [
{
"productName": "VXC to test VNIC",
"rateLimit": 100,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":2,
"innerVlan": 144
},
"bEnd": {
"productUid" : "{{ googleProductUid }}",
"partnerConfig": {
"connectType": "GOOGLE",
"pairingKey": "{{ googlePairingKey }}"
}
}
}
]
}
]
Sobald Sie das VXC abgeschlossen und bereitgestellt haben, kehren Sie zur Google Cloud Console zurück und akzeptieren Sie den Anhang.
Nach dem Senden der Anfrage erhalten Sie eine erfolgreiche Antwort, wenn das VXC bestellt wurde.
Hier ist eine Beispielantwort:
{
"message": "VXC [27139b23-0afe-4e48-9322-eea95d2d6b74] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1709823461856,
"vxcOrderId": 139952,
"payerMegaPortId": 190079,
"nonPayerMegaPortId": 95335,
"payerMegaPortName": "MVE for VNIC config",
"nonPayerMegaPortName": "London (lhr-zone1-832)",
"payerCompanyId": 1153,
"nonPayerCompanyId": 90,
"payerLocationId": 89,
"nonPayerLocationId": 90,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "Google inc..",
"payerMegaPortNsId": 510708,
"nonPayerMegaPortNsId": 217347,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 144,
"nonPayerInnerVlanId": null,
"payerApproverName": "David Sloan",
"payerApproverId": 41315,
"nonPayerApproverName": "David Sloan",
"nonPayerApproverId": 41315,
"payerApproval": 1709823461831,
"nonPayerApproval": 1709823461850,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from MVE for VNIC config to London (lhr-zone1-832)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 100,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 190111,
"vxcJTechnicalServiceUid": "27139b23-0afe-4e48-9322-eea95d2d6b74",
"provisionDate": 1709823461826,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": null,
"amsixConnectConfigDto": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_METRO_VXC",
"costCentre": null,
"azureServiceKey": null,
"oracleVirtualCircuitId": null,
"serviceKey": null,
"vxc": {
"serviceName": "VXC to test VNIC",
"name": "VXC to test VNIC",
"secondaryName": null,
"technicalServiceId": 190111,
"technicalServiceUid": "27139b23-0afe-4e48-9322-eea95d2d6b74",
"requestedDate": 1709823461826,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 1153,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 181659,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1709823461844,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 1,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 100,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "UK",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aMetro": null,
"aCountry": null,
"aLocationId": null,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "b0dedbd2-ecc7-4bad-a13b-6c34b4005115",
"buyoutPort": null,
"virtual": false,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
},
"connectType": "GOOGLE",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}