Criando um VXC entre uma Port e Microsoft Azure com a API
Este tópico descreve o procedimento da API para criar um VXC de uma Port para o Microsoft Azure ExpressRoute, incluindo como consultar as localizações de portas do Azure e solicitar os VXCs.
A implantação de Port para o Azure inclui estas tarefas:
-
Configurar um circuito ExpressRoute no console do Azure
Quando implantado, você recebe uma chave de serviço. A chave de serviço está vinculada às portas atribuídas no Azure. Ao validar uma chave de serviço, a resposta mostra as portas primária e secundária atribuídas no Azure. Você pode usar a chave de serviço duas vezes - uma vez para se conectar à primária e uma segunda vez para criar outra conexão para a porta secundária.
Para obter mais informações, consulte o tópico de ajuda da Microsoft Tutorial: Create and modify an ExpressRoute circuit. -
Com a chave de serviço, crie e implante seus VXCs a partir do Megaport Portal
Esta etapa usa a API – as outras etapas estão fora da Megaport, no ambiente do Azure.
-
Com um VXC implantado no seu circuito, configure Peering no portal do Azure
As informações de Peering são compartilhadas entre os circuitos primário e secundário, assim como a VLAN interna atribuída ao peer.
Para obter mais informações, consulte o tópico de ajuda da Microsoft Create and modify peering for an ExpressRoute circuit. -
Configurar o equipamento nas instalações do cliente (CPE)
Antes de começar, obtenha um token de acesso válido. Para mais informações, consulte Criando uma Chave de API.
Validar a chave de serviço
Ao usar a API para validar uma chave de serviço do Azure, a resposta inclui detalhes do ExpressRoute das portas e peers associados. Você precisa dos detalhes da porta para criar os VXCs.
Para validar a chave de serviço na coleção do Postman
-
No Postman, expanda Cloud Connectivity > Port > Azure (Conectividade de Nuvem > Port > Azure) na navegação à esquerda e selecione GET Look Up Azure Service Key (GET Consultar Chave de Serviço do Azure).
-
Adicione a chave de serviço ao endpoint.
-
Clique em Send (Enviar) para fazer uma solicitação GET ao servidor da API.
GET {baseUrl}/v2/secure/azure/{service_key}
Aqui está um exemplo de resposta para uma nova chave (sem VXCs configurados):
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": null,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
O valor megaports:vxc é null para ambos os Ports, indicando que estão disponíveis para novos VXCs.
Para mais informações sobre cada campo de resposta, consulte Campos de Resposta da Chave de Serviço do Azure.
Criar e implementar os VXCs
Com os detalhes da chave de serviço, crie um VXC para a porta primária e outro VXC para a porta secundária.
Para criar os VXCs
-
Selecione POST Create VXC to Azure (v3) (POST Criar VXC para Azure (v3)).
Dica
Para testar sua solicitação antes de fazer o pedido e ver detalhes de preços, você pode usar: POST {baseUrl}/v3/networkdesign/validate
-
Atualize o Body da solicitação com o
productUiddo Port, o nome do VXC, oproductUidda porta primária do Azure e a chave de serviço. A velocidade máxima (rateLimit) é definida no valor de largura de banda (bandwidth) da resposta da chave de serviço. Neste caso, é 200. -
Clique em Send (Enviar) para enviar a solicitação.
POST {baseUrl}/v3/networkdesign/buy
[
{
"productUid": "1544f278-ec03-11e5-9ce9-5e5517507c66", //port UID of your Megaport (A-End)
"associatedVxcs": [
{
"productName": "Primary Azure VXC",
"rateLimit": 200,
"term":12,
"shutdown": false,
"promoCode": "promox3mnthfree2",
"aEnd": {
"vlan": 102
},
"bEnd": {
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008", //retrieved port UID from the Azure service key lookup
"partnerConfig" : {
"connectType": "AZURE",
"serviceKey": "3e2480b2-b4d5-424b-976a-7b0de65a1b62" //service key from lookup response
}
}
}
]
}
]
Quando você tiver configurado seus VXCs primário e secundário para as portas do Azure, outra consulta de chave de serviço mostra os VXCs associados às portas do Azure. Os VXCs são identificados por um número de ID (megaports:vxc).
{
"message": "Successful lookup",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": {
"managed": false,
"connectType": "AZURE",
"resource_type": "csp_connection",
"bandwidth": 200,
"service_key": "3e2480b2-b4d5-424b-976a-7b0de65a1b62",
"vlan": 3289,
"megaports": [
{
"portSpeed": 10000,
"name": "Washington DC Primary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "a7ae8a35-433e-44aa-87cb-a1b7995ab008",
"nServiceId": 32832,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60621,
"port": 14570,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 14570,
"type": "primary",
"companyId": 1475
},
{
"portSpeed": 10000,
"name": "Washington DC Secondary",
"state": "VA",
"description": "Azure ExpressRoute at Equinix DC2/6",
"productUid": "07ab0ee6-7f77-41ac-bbe6-335e3ee6d182",
"nServiceId": 36431,
"companyUid": "c40de5ed-4707-4471-a78c-69436de2c505",
"country": "USA",
"vxc": 60622,
"port": 16108,
"companyName": "Azure ExpressRoute",
"locationId": 67,
"productId": 16108,
"type": "secondary",
"companyId": 1475
}
],
"peers": []
}
}
Para concluir a configuração, configure peering no portal do Azure e configure seus dispositivos CPE.