Criando uma Conexão Megaport Internet a partir de uma Porta com a API

Este tópico descreve o procedimento de API para criar uma conexão Megaport Internet a partir de uma Porta.

Este processo inclui os seguintes passos:

Procurar pelo productUid da terminação A usando GET Product List para identificar a Porta no seu local da Megaport.
Procurar pelo productUid da terminação B usando GET Partner Megaports para identificar o roteador de internet (Porta). Use vxcPermitted True e connectType TRANSIT.
Validar a configuração usando o Body de solicitação necessário.
Comprar a conexão Megaport Internet usando o Body de solicitação validado.

Aviso

Para mais informações sobre criar uma conexão Megaport Internet para um MVE a fim de providenciar conectividade e para se cadastrar e se comunicar com a rede overlay da SD-WAN, veja Megaport Virtual Edge (MVE) no portal do desenvolvedor da API.

Para mais informações sobre conexões Megaport Internet veja Visão Geral do Megaport Internet.

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

Para obter o productUid da Porta

No Postman, clique em Product Details no menu de navegação à esquerda e clique em GET Product List.
Clique em Send.
Dos detalhes de produto retornados, localize o valor productUid da porta a partir da qual você deseja se conectar.
Este exemplo usa a seguinte Porta:
```
"productName": "GB Megaport Internet Port"
"productUid": "ecdc7ee9-a197-4686-8b16-046cfc07797a"
```

Para obter o productUid do roteador de internet(Porta terminação B)

No Postman, clique em Locations no menu de navegação à esquerda e clique em GET Partner Megaports.
Atualize os Query Parameters para que o connectType esteja definido como TRANSIT e vxcPermitted esteja definido como True.
Isso retornará Portas que suportam uma conexão Megaport Internet e nas quais novas conexões serão aceitas.
Clique em Send.
Dos detalhes de Parceiros Megaport retornados, localize o valor productUid da Porta ou roteador de internet ao qual você deseja se conectar.
Este exemplo usa a seguinte Porta:
```
"productUid": "874dbcff-a1f9-4328-9c08-112cd87c20f6"
```

Para revisar detalhes de preço e validar a configuração da conexão Megaport Internet

No Postman, expanda Connections > Megaport Internet no menu de navegação à esquerda e clique em POST Validate Megaport Internet Order (v3).
Atualize o Body com o productUid de cada terminação da conexão.
Você também pode mudar valores adicionais, tais como nome, limite de taxa, e vigência do contrato.
Clique em Send para fazer uma solicitação POST.
```
POST {baseUrl}/v3/networkdesign/validate
```

[
 {
   "productUid": "ecdc7ee9-a197-4686-8b16-046cfc07797a",
   "associatedVxcs": [
     {    
      "rateLimit": 10000,
      "term": 12,
      "productName": "Example Megaport Internet Connection",
      "aEnd": {
        "productName": "GB Megaport Internet Port"
      },  
      "bEnd": {
        "productUid": "874dbcff-a1f9-4328-9c08-112cd87c20f6"
      },
      "productType": "VXC",
      "connectType": "TRANSIT",
      "shutdown": false
     }
 ]
 }
]

Após validar a solicitação e revisar os detalhes de preço na resposta, faça o pedido da conexão Megaport Internet.

Para fazer o pedido da conexão Megaport Internet

Copie o Body validado de POST Validate Megaport Internet Order (v3) e cole-o no Body de POST Buy Megaport Internet (v3).
Clique em Send para postar a solicitação.
```
POST {baseUrl}/v3/networkdesign/buy
```
A conexão Megaport Internet resultante aparecerá no Megaport Portal.

Portal Visualização da API Criada Megaport Internet Connection