Criando um VXC entre uma Porta e a Microsoft Azure com a API

Este tópico descreve o processo via API para criar um VXC de uma Porta até o Microsoft Azure ExpressRoute, incluindo como pesquisar por locais de porta da Azure e fazer o pedido dos VXCs.

O lançamento da Porta até a Azure inclui as seguintes tarefas:

Definir um circuito ExpressRoute no console da Azure.
Ao ser lançado, você receberá uma chave de serviço. A chave de serviço está ligada às portas designadas na Azure. Quando você valida uma chave de serviço, a resposta mostra as portas primária e secundária designadas na Azure. Você pode usar a chave de serviço duas vezes - uma para se conectar à porta primária e a segunda para criar outra conexão para a porta secundária.
Para mais informações, veja o tópico de ajuda da Microsoft Tutorial: Criar e modificar um circuito ExpressRoute circuit.
Com a chave de serviço, crie e lance os VXCs a partir do Megaport Portal.
Essa etapa usa a API – as outras etapas ocorrem fora da Megaport no ambiente da Azure.
Com um VXC lançado no seu circuito, configure o peering no portal da Azure.
As informações de peering são compartilhadas entre o circuito primário e secundário, assim como a VLAN interna designada ao peer.
Para mais informações, veja o tópico de ajuda da Microsoft Criar e modificar peering para um circuito ExpressRoute circuit.
Configure o dispositivo de equipamento nas instalações do cliente (customer premises equipment – CPE).

Antes de começar, obtenha um token de acesso válido. Para mais informações, veja Criando uma Chave API.

Validar a chave de serviço

Quando você usa a API para validar uma chave de serviço da Azure, a resposta inclui detalhes do ExpressRoute sobre as portas e peers associados. Você precisa dos detalhes das portas para criar os VXCs.

Para validar a chave de serviço na coleção do Postman

No Postman, expanda Cloud Connectivity > Port > Azure no menu de navegação à esquerda e selecione GET Look Up Azure Service Key.
Adicione a chave de serviço ao endpoint.
Clique em Send para fazer uma solicitação GET ao servidor API.
```
GET {baseUrl}/v2/secure/azure/{service_key}
```

A seguir, um exemplo de resposta para uma chave nova (sem VXCs configurados):

{
    "message": "Busca bem-sucedida",
    "terms": "Esses dados estão sujeitos à Política de Uso Aceitável 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 é nulo para ambas as Portas, indicando que elas estão disponíveis para novos VXCs.

Para mais informações sobre cada campo de resposta, veja Campos de Resposta da Chave de Serviço do Azure.

Criar e lançar 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).

Dica

Para testar a sua solicitação antes de fazer o pedido e ver detalhes de preço, você pode usar: POST {baseUrl}/v3/networkdesign/validate
Atualize o corpo (Body) da solicitação com o productUid da Porta, o nome do VXC, o productUid da porta primária da Azure, e a chave de serviço. A velocidade máxima (rateLimit) é definida no valor de bandwidth da resposta da chave de serviço. Neste caso, é 200.
Clique em Send 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,
                "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
                    }
                }
            }
        ]
    }
]

Depois de você ter configurado seus VXCs primário e secundário às portas da Azure, outra pesquisa de chave de serviço mostra os VXCs associados às portas da Azure. Os VXCs são identificados por um número de ID (megaports:vxc).

{
    "message": "Consulta realizada com sucesso.",
    "terms": "Esses dados estão sujeitos à Política de Uso Aceitável. 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 completar a configuração, configure o peering no portal da Azure e configure seus dispositivos CPE.