Criando um VXC para a AWS com a API
Este tópico descreve o procedimento da API para criar um VXC de um Port para a AWS, incluindo como consultar locais de interconexão em nuvem, validar a conexão e solicitar o VXC.
O exemplo neste tópico cria uma conexão Hosted VIF para a AWS com taxa de dados de 500 Mbps. Para acompanhar este exemplo, use a URL do ambiente de staging, que permite configurar as conexões, mas não as implementa nem cobra pelos serviços.
Antes de começar, obtenha um token de acesso válido. Para mais informações, consulte Criando uma chave de API.
Dica
Para ver todas as opções para as requisições usadas neste exemplo, consulte https://dev.megaport.com.
Consultar detalhes de localização da porta da AWS
Para criar um VXC para a AWS, você precisa conhecer os detalhes da porta da AWS. Use a API para retornar as interfaces que a Megaport tem com provedores de serviços de nuvem, a fim de identificar os detalhes necessários da porta da AWS.
Para consultar os detalhes de localização da porta da AWS na coleção do Postman
-
Expanda a pasta Locations (Locais) na navegação à esquerda e clique em GET Partner Megaports (GET Megaports de Parceiros).
-
Clique em Send (Enviar) para fazer uma solicitação GET ao servidor da API.
GET {baseUrl}/v2/dropdowns/partner/megaportsEsta solicitação retorna todas as interfaces que a Megaport tem com provedores de serviços de nuvem. Você pode pesquisar clicando no ícone de lupa e inserindo um local, data center ou outro parâmetro no campo de pesquisa.
O connectType indica o provedor de serviços de nuvem. A AWS inclui “AWS” para Hosted VIFs e “AWSHC” para Hosted Connections.
Você pode filtrar os resultados por
connectTypeevxcPermitted.GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueEste exemplo usa uma porta no Interxion DUB2 que está aceitando VXCs (
“vxcPermitted”: true) e está na região eu-west-1.
{
"connectType": "AWS",
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"vxcPermitted": true,
"companyUid": "623cb950-abb4-4b07-b372-8cf55756c322",
"companyName": "AWS",
"title": "EU (Ireland) (eu-west-1)",
"locationId": 96,
"speed": 10000,
"rank": 61,
"lag_id": 2,
"lag_primary": true,
"aggregation_id": 54188
},
Criar e implementar um VXC
Com os detalhes da porta AWS da API GET Partner Megaports (GET Megaports de Parceiros), você pode validar e então criar um VXC.
Para testar e validar o pedido
-
No Postman, expanda Cloud Connectivity > Port > AWS Direct Connect (Conectividade com a Cloud > Port > AWS Direct Connect) na navegação à esquerda e selecione POST Validate AWS - Hosted VIF (v3) (POST Validar AWS - Hosted VIF (v3)).
-
Atualize o Body da solicitação com o
productUiddo Port, oproductUidda porta AWS e o ID da conta AWS.
Você também pode alterar valores adicionais, como nome, rate limit, prazo do contrato, ID da VLAN, valores de ASN, authKey e endereçamento IP. -
Clique em Send (Enviar) para enviar a solicitação POST.
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 777
},
"bEnd": {
"productUid": "6cc21ccb-5ecc-4869-ab0e-b3fa17f5110f",
"partnerConfig": {
"connectType": "AWS",
"name": "Amazon name for service",
"type": "private",
"asn": 65105,
"amazonAsn": 64555,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Quando validado, você está pronto para fazer o pedido do VXC.
Para criar um VXC
-
Copie o Body validado de POST Validate AWS - Hosted VIF (v3) (POST Validar AWS - Hosted VIF (v3)) e cole no Body de POST Buy AWS - Hosted VIF (v3) (POST Comprar AWS - Hosted VIF (v3)).
-
Clique em Send (Enviar) para enviar a solicitação.
POST {baseUrl}/v3/networkdesign/buy
Aqui está um exemplo de resposta bem-sucedida.
{
"message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] created. ",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"createDate": 1588868593704,
"vxcOrderId": 42328,
"payerMegaPortId": 68124,
"nonPayerMegaPortId": 52786,
"payerMegaPortName": "API Port",
"nonPayerMegaPortName": "EU (Ireland) (eu-west-1)",
"payerCompanyId": 2278,
"nonPayerCompanyId": 117,
"payerLocationId": 89,
"nonPayerLocationId": 96,
"salesId": null,
"payerCompanyName": "Megaport Lab",
"nonPayerCompanyName": "AWS",
"payerMegaPortNsId": 138231,
"nonPayerMegaPortNsId": 221182,
"payerVlanId": 777,
"nonPayerVlanId": 0,
"payerApproverName": "Paul McGuinness",
"payerApproverId": 12695,
"nonPayerApproverName": "Paul McGuinness",
"nonPayerApproverId": 12684,
"payerApproval": 1582268553574,
"nonPayerApproval": 1228868693614,
"fixedTerm": true,
"duration": 1,
"rollover": true,
"serviceName": "from API Port to EU (Ireland) (eu-west-1)",
"payerStatus": "APPROVED",
"nonPayerStatus": "APPROVED",
"speed": 500,
"distanceBand": "ZONE",
"intercapPath": "",
"awsId": null,
"promoCode": null,
"rateType": "MONTHLY",
"vxcJTechnicalServiceId": 57115,
"vxcJTechnicalServiceUid": "47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e",
"provisionDate": 1588868593517,
"orderType": "NEW",
"monthlyDiscountAmount": null,
"discountMonths": null,
"amazonDirectConnectConfigDto": {
"type": "private",
"asn": 65105,
"ownerAccount": "XXXXXXXXXXXX",
"authKey": "123456",
"customerIpAddress": null,
"amazonIpAddress": null,
"prefixes": "10.0.1.0/24",
"name": "Amazon name for service"
},
"amsixConnectConfigDto": null,
"webAirProvItem": null,
"sdrcProvItem": null,
"rate": null,
"setup": null,
"asn": null,
"bgpPassword": null,
"usageAlgorithm": "POST_PAID_HOURLY_SPEED_LONG_HAUL_VXC",
"costCentre": null,
"azureServiceKey": null,
"oracleVirtualCircuitId": null,
"serviceKey": null,
"connectType": "AWS",
"payerConfig": {},
"nonPayerConfig": {},
"attributeTags": {},
"fullyApproved": true
}
]
}
O Port e o VXC agora aparecem no Megaport Portal.
Para este exemplo, a AWS Hosted VIF aparecerá na conta do portal da AWS em Direct Connect - Virtual Interfaces. O titular da conta pode aceitar a Virtual Interface e conectá-la a um Virtual Private Gateway ou a um Direct Connect Gateway e depois às suas VPCs.