Criando um VXC entre um MVE e a Google Cloud com a API
Este tópico descreve o procedimento API para criar um VXC de um MVE a serviços da Google Cloud. A configuração é um processo de duas etapas: primeiro é preciso encontrar detalhes de conexão com a chave de pareamento do Google e então é possível criar o VXC.
Aviso
Antes de poder criar uma conexão à Google Cloud, você precisa criar um anexo (attachment) do Partner Interconnect no Google Cloud Console ou no gcloud CLI. Como parte da criação desse anexo, você receberá uma chave de pareamento que contém os detalhes da conexão do Google.
O lançamento do MVE até a Google Cloud inclui as seguintes tarefas:
-
Criar um anexo (attachment) do Partner Interconnect no Google Cloud Console ou no gcloud CLI
Crie um anexo do Partner Interconnect no Google Cloud Console ou no gcloud CLI. Copie a chave de pareamento que é mostrada durante a criação do anexo. Para mais detalhes, veja a documentação do Google em Google Partner Interconnects.
-
Validar a chave de pareamento do Google
Ao encomendar um serviço da Google Cloud, use a chave de pareamento e garanta que há uma porta disponível para a conexão.
O Google exige que a largura de banda no VXC corresponda a uma das larguras de banda predefinidas na lista retornada pela pesquisa da chave de pareamento.
-
Criar e lançar um VXC
Com os detalhes validados da porta e da chave de pareamento, crie um VXC para a Google Cloud a partir do MVE.
Detalhes de configuração são especificados no corpo (Body) da solicitação.
Antes de começar, obtenha um token de acesso válido. Para mais informações, veja Criando uma Chave API.
Validar a chave de pareamento do Google
Use a API para validar uma chave de pareamento da Google Cloud. A resposta inclui detalhes das portas e peers associados. Você precisará dos detalhes de porta para criar o VXC.
Na resposta da API, portas disponíveis estarão listadas como "vxc":null e portas com um valor designado não estarão disponíveis.
O Google exige que a largura de banda no VXC corresponda a uma das larguras de banda predefinidas na lista retornada pela pesquisa da chave de pareamento.
Para validar a chave de pareamento
-
Use a API GET Look Up Google Pairing Key para pesquisar detalhes de local da Google Cloud com a chave de pareamento:
GET {baseUrl}/v2/secure/google/{pairing_key}
A seguir, uma resposta de exemplo para uma chave de pareamento com uma porta disponível (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
],
"megaports": [
{
"productId": 81456,
"productUid": "4aaf6946-6166-4f41-b726-b388aad98fcb",
"name": "Sydney (syd-zone1-1660)",
"nServiceId": 181638,
"description": "Google Inc at NextDC S1",
"companyId": 90,
"companyUid": "29ba879b-45c8-48eb-bd97-618d0f20ea04",
"companyName": "Google Inc",
"portSpeed": 100000,
"locationId": 10,
"state": "NSW",
"country": "Australia",
"port": 81456,
"vxc": null
}
],
"resource_type": "csp_connection",
"ports": [
{
"service_id": 28350,
"vxc_service_ids": []
},
{
"service_id": 90779,
"vxc_service_ids": []
},
{
"service_id": 181638,
"vxc_service_ids": []
}
]
}
}
Criar e lançar um VXC
Com os detalhes validados da porta e da chave de pareamento, crie o VXC para a Google Cloud a partir do MVE.
Você deve especificar os detalhes de configuração no corpo (Body) da solicitação. O primeiro productUididentifica o ID do MVE e o bEnd: productUid identifica o local da Google Cloud da chave de pareamento. Você também precisa providenciar a sua chave de pareamento do Google na solicitação. Apenas o aEnd innerVlan precisa ser especificado.
Dica
Para testar a sua solicitação antes de fazer o pedido e ver detalhes de preço, use o endpoint /v3/networkdesign/validate com a mesma configuração de Body.
Para criar um VXC
-
Crie uma solicitação com o endpoint POST Create VXC to Google Cloud (v3):
POST {baseUrl}/v3/networkdesign/buy -
Atualize o Body da solicitação com o
productUiddo MVE, o nome do VXC, oproductUidda porta da Google Cloud, e a chave de pareamento.A seguir, uma solicitação de exemplo:
[
{
"productUid": "8acc7925-4fda-45a3-a955-ce5d89c59593",
"associatedVxcs": [
{
"productName": "Google MVE VXC",
"rateLimit": 100,
"term": 12,
"shutdown": false,
"aEnd": {
"innerVlan": 0
},
"bEnd": {
"productUid": "4aaf6946-6166-4f41-b726-b388aad98fcb",
"partnerConfig": {
"connectType": "GOOGLE",
"pairingKey": "246bf9c3-34b5-49f3-b8d9-73c04399673c/australia-southeast1/1"
}
}
}
]
}
]
Após enviar a solicitação, você receberá uma resposta de sucesso quando o VXC tiver sido encomendado.
A seguir, uma resposta de exemplo:
{
"message": "VXC [6516dd8a-6558-4867-aa38-20830ea89cbb] created.",
"terms": "This data is subject to the Acceptable Use Policy. https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1680077872960,
"vxcOrderId": 113661,
"payerMegaPortId": 155247,
"nonPayerMegaPortId": 81456,
"payerMegaPortName": "Greg MVE",
"nonPayerMegaPortName": "Sydney (syd-zone1-1660)",
"payerCompanyId": 1153,
"nonPayerCompanyId": 90,
"payerLocationId": 2,
"nonPayerLocationId": 10,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "Google Inc",
"payerMegaPortNsId": 398160,
"nonPayerMegaPortNsId": 181638,
"payerVlanId": 0,
"nonPayerVlanId": 0,
"payerInnerVlanId": 0,
"nonPayerInnerVlanId": null,
"payerApproverName": "Greg Brown",
"payerApproverId": 50402,
"nonPayerApproverName": "Greg Brown",
"nonPayerApproverId": 50402,
"payerApproval": 1680077872920,
"nonPayerApproval": 1680077872944,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from Greg MVE to Sydney (syd-zone1-1660)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 100,
"distanceBand": "METRO",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"dealUid": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 155249,
"vxcJTechnicalServiceUid": "6516dd8a-6558-4867-aa38-20830ea89cbb",
"provisionDate": 1680077872914,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": null,
"amsixConnectConfigDto": null,
"webAirProvItem": 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": "Test Google MVE VXC",
"name": "Test Google MVE VXC",
"secondaryName": null,
"technicalServiceId": 155249,
"technicalServiceUid": "6516dd8a-6558-4867-aa38-20830ea89cbb",
"requestedDate": 1680077872914,
"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": 147194,
"billableUsageAlgorithm": null,
"productType": "VXC",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": "METRO",
"intercapPath": "",
"marketplaceVisibility": true,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1680077872938,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 12,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 100,
"errorMessage": null,
"market": "Australia",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": null,
"bLocation": null,
"aLocationId": null,
"bLocationId": null,
"attributeTags": {},
"createdBy": "f39b8983-256e-4643-adec-9f0b5da09ab7",
"buyoutPort": null,
"virtual": false,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
},
"connectType": "GOOGLE",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"serviceLicense": null,
"originDomain": null,
"fullyApproved": true
}
]
}
Depois de ter completado e lançado o VXC, volte ao Google Cloud Console e aceite o anexo.