Criando um VXC para a AWS com a API
Este tópico descreve o procedimento via API para criar um VXC para a AWS, incluindo como pesquisar locais de interconexão de nuvem, validar a conexão, e fazer o pedido do VXC.
O exemplo neste tópico cria uma conexão VIF Hospedada para a AWS com uma taxa de dados de 500 Mbps. Para seguir este exemplo passo a passo, use a URL de ambiente de testes (staging), que permite configurar as conexões mas não lança nem gera cobranças pelos serviços.
Antes de começar, obtenha um token de acesso válido. Para mais informações, veja Criando uma Chave API.
Dica
Para ver todas as opções para as solicitações usadas neste exemplo, veja https://dev.megaport.com.
Buscar os detalhes de local da porta da AWS
Para criar um VXC para a AWS, você precisa saber os detalhes da porta AWS. Use a API para recuperar as interfaces que a Megaport tem com provedores de serviços de nuvem para identificar os detalhes de porta AWS necessários.
Para pesquisar detalhes do local da porta AWS na coleção do Postman
-
Expanda a pasta Locais no menu de navegação à esquerda e clique em GET Partner Megaports.
-
Clique em Enviar para fazer uma solicitação GET ao servidor API.
GET {baseUrl}/v2/dropdowns/partner/megaportsEssa solicitação retorna todas as interfaces que a Megaport tem com Provedores de Serviços de Nuvem. Você pode buscar clicando na lupa e inserindo um local, data center, ou outro parâmetro no campo de busca.
O connectType indica o Provedor de Serviço de Nuvem. A AWS inclui “AWS” para VIFs Hospedadas e “AWSHC” para Conexões Hospedadas.
Você pode filtrar os resultados por
connectTypeevxcPermitted.GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=trueEste exemplo usa uma porta em 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 lançar um VXC
Com os detalhes da porta AWS da API GET Partner Megaports, você pode validar e então criar um VXC.
Para testar e validar o pedido
-
No Postman, expanda Cloud Connectivity > Port > AWS Direct Connect no menu de navegação à esquerda e selecione POST Validate AWS - Hosted VIF (v3).
-
Atualize o corpo (Body) da solicitação com o
productUidda Porta, oproductUidda porta AWS, e o ID da conta da AWS.
Você também pode mudar valores adicionais, tais como nome, limite de taxa, vigência do contrato, ID da VLAN, valores ASN, authKey, e endereçamento IP. -
Clique em Enviar para enviar a solicitação.
POST {baseUrl}/v3/networkdesign/validate
[
{
"productUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
"associatedVxcs": [
{
"productName": "My Amazon Direct Connect",
"rateLimit": "500",
"term": 12,
"shutdown": false,
"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": "312345679135",
"authKey": "123456",
"prefixes": "10.0.1.0/24",
"customerIpAddress": null,
"amazonIpAddress": null
}
}
}
]
}
]
Após validação, você estará pronto para fazer o pedido do VXC.
Para criar um VXC
-
Copie o Body validado de POST Validate AWS - Hosted VIF (v3) e cole-o no Body de POST Buy AWS - Hosted VIF (v3).
-
Clique em Enviar para postar a solicitação.
POST {baseUrl}/v3/networkdesign/buy
A seguir, um exemplo de resposta de sucesso.
{
"message": "VXC [47d6cc4d-6a1a-4301-b06c-cebb5f9b8f3e] criar. ",
"terms": "Esses dados estão sujeitos à Política de Uso Aceitável. 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": "312345679135",
"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
}
]
}
A porta e o VXC agora aparecerão no Megaport Portal.
Para esse exemplo, o VIF Hospedado AWS aparecerá na conta do portal AWS em Direct Connect - Virtual Interfaces. O proprietário da conta pode aceitar a Interface Virtual e conectá-la a um Virtual Private Gateway ou a um Direct Connect Gateway e então aos seus VPCs.