Creazione di un VXC tra un MVE e Google Cloud con l’API
Questo argomento descrive la procedura API per creare un VXC da un MVE ai servizi di Google Cloud. La configurazione è un processo in due passaggi: prima si cercano i dettagli della connessione con la chiave di accoppiamento di Google, poi si crea il VXC su una specifica vNIC del tuo MVE.
Nota
Prima di poter creare una connessione a Google Cloud, è necessario creare un allegato Partner Interconnect in Google Cloud Console o gcloud CLI. Come parte della creazione dell’allegato, viene fornita una chiave di accoppiamento contenente i dettagli di connessione di Google.
Il rilascio di MVE a Google Cloud include queste attività:
-
Crea un allegato Partner Interconnect in Google Cloud Console o gcloud CLI
Crea un allegato Partner Interconnect in Google Cloud Console o gcloud CLI. Copia la chiave di accoppiamento fornita come parte della creazione dell’allegato. Per ulteriori dettagli, consulta la documentazione di Google su Google Partner Interconnects.
-
Convalida la chiave di accoppiamento di Google
Quando ordini un servizio Google Cloud, utilizza la chiave di accoppiamento e assicurati che ci sia una porta disponibile per una connessione.
Google richiede che la larghezza di banda su VXC corrisponda a una delle larghezze di banda predefinite nell’elenco restituito dalla ricerca della chiave di accoppiamento.
-
Crea e implementa un VXC
Con la chiave di accoppiamento e i dettagli della porta convalidati, crea il VXC a Google Cloud dal MVE.
I dettagli della configurazione sono specificati nel corpo della richiesta.
Prima di iniziare, ottieni un token di accesso valido. Per maggiori informazioni, vedi Creazione di una chiave API.
Convalida la chiave di accoppiamento di Google
Utilizza l’API per convalidare una chiave di accoppiamento Google Cloud. La risposta include i dettagli delle porte e dei peer associati. Hai bisogno dei dettagli della porta per creare il VXC.
Nella risposta dell’API, le porte disponibili sono elencate come "vxc":null e le porte con un valore assegnato non sono disponibili.
Google richiede che la larghezza di banda su VXC corrisponda a una delle larghezze di banda predefinite nell’elenco restituito dalla ricerca della chiave di accoppiamento.
Per convalidare la chiave di accoppiamento
-
Utilizza GET Look Up Google Pairing Key API per cercare i dettagli della posizione di Google Cloud con la chiave di accoppiamento:
GET {baseUrl}/v2/secure/google/{pairing_key}
Ecco un esempio di risposta per una chiave di accoppiamento con una porta disponibile (vxc = null).
{
"message": "Ricerca effettuata con successo",
"terms": "Questi dati sono soggetti alla Politica di uso accettabile 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": "Stoccolma (arn-zone1-208)",
"nServiceId": 65391,
"description": "Google inc.. presso Interxion STO5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 98,
"state": null,
"country": "Svezia",
"port": 28845,
"vxc": null
},
{
"productId": 45873,
"productUid": "832a017d-74ca-45e8-a225-e3d794a079d7",
"name": "Zurigo (zrh-zone1-81)",
"nServiceId": 103010,
"description": "Google inc.. presso Interxion ZH1",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 10000,
"locationId": 557,
"state": null,
"country": "Svizzera",
"port": 45873,
"vxc": null
},
{
"productId": 81531,
"productUid": "6e587057-f012-4600-896f-9ee171fdd444",
"name": "Francoforte (fra-zone1-683)",
"nServiceId": 181786,
"description": "Google inc.. presso Equinix FR5",
"companyId": 90,
"companyUid": "{{ companyUid }}",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 131,
"state": null,
"country": "Germania",
"port": 81531,
"vxc": null
},
{
"productId": 84769,
"productUid": "f25e581b-3c0e-4069-8147-78cce082357e",
"name": "Amsterdam (ams-zone1-1236)",
"nServiceId": 188925,
"description": "Google inc.. presso Equinix AM1",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 85,
"state": null,
"country": "Paesi Bassi",
"port": 84769,
"vxc": null
},
{
"productId": 95335,
"productUid": "9fde43f5-2f00-41ed-bb60-45c446ea43df",
"name": "Londra (lhr-zone1-832)",
"nServiceId": 217347,
"description": "Google inc.. presso Equinix LD5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 90,
"state": null,
"country": "Regno Unito",
"port": 95335,
"vxc": null
},
{
"productId": 153623,
"productUid": "ae8d21b5-2db6-4f72-a465-624c914f4918",
"name": "Parigi (cdg-zone1-1536)",
"nServiceId": 391882,
"description": "Google inc.. presso Interxion PAR5",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 527,
"state": null,
"country": "Francia",
"port": 153623,
"vxc": null
},
{
"productId": 162678,
"productUid": "7d1cca03-eb3d-4be4-a145-de8e8dffec3f",
"name": "Francoforte (fra-zone1-58)",
"nServiceId": 420550,
"description": "Google inc.. presso Interxion FRA6",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google inc..",
"portSpeed": 100000,
"locationId": 130,
"state": null,
"country": "Germania",
"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": []
}
]
}
}
Creare e distribuire un VXC su uno specifico vNIC
Con la chiave di associazione validata e i dettagli della porta, crea il VXC verso Google Cloud dal MVE.
Specifica i dettagli di configurazione nel corpo della richiesta. Il primo productUid identifica l’ID del MVE e il bEnd: productUid identifica la posizione Google Cloud dalla chiave di associazione. Devi anche fornire la tua chiave di associazione Google nella richiesta. È necessario specificare solo l’innerVlan dell’aEnd.
Suggerimento
Per testare la tua richiesta prima di ordinare e vedere i dettagli dei prezzi, usa l’endpoint /v3/networkdesign/validate con la stessa configurazione del corpo.
Per creare un VXC
-
Crea una richiesta con l’endpoint POST Create VXC to Google Cloud (v3):
POST {baseUrl}/v3/networkdesign/buy -
Aggiorna il corpo della richiesta con il
productUiddel MVE, il nome del VXC, ilproductUiddella porta Google Cloud, impostavNicIndexa 2 (interfaccia 3), e la chiave di associazione.Nota
Il numero vNIC si riferisce alle seguenti interfacce MVE:
- vNIC 0 = interfaccia 1 sul MVE
- vNIC 1 = interfaccia 2 sul MVE
- vNIC 2 = interfaccia 3 sul MVE
- vNIC 3 = interfaccia 4 sul MVE
- vNIC 4 = interfaccia 5 sul MVE
Ecco un esempio di richiesta:
[
{
"productUid": "{{ mveid }}",
"associatedVxcs": [
{
"productName": "VXC per testare VNIC",
"rateLimit": 100,
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vNicIndex":2,
"innerVlan": 144
},
"bEnd": {
"productUid" : "{{ googleProductUid }}",
"partnerConfig": {
"connectType": "GOOGLE",
"pairingKey": "{{ googlePairingKey }}"
}
}
}
]
}
]
Una volta completato e distribuito il VXC, torna alla Google Cloud Console e accetta l’allegato.
Dopo aver inviato la richiesta, riceverai una risposta di successo quando il VXC sarà stato ordinato.
Ecco un esempio di risposta:
{
"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
}
]
}