API API API API API API API API API API API API API API API API API API API API API API API Criando um VXC para AWS a partir do MVE

Criando um VXC entre um MVE e a AWS com a API

Este tópico descreve o procedimento da API para criar um VXC de um MVE para a AWS, incluindo como pesquisar locais da AWS e solicitar VXCs em vNICs específicas.

Você pode configurar dois tipos de conexões AWS para um MVE: uma AWS Hosted VIF e uma AWS Hosted Connection.

Você pode distinguir o tipo de conexão suportada pelos locais de parceiros usando o atributo connectType. Conexões Hosted VIF são connectType=AWS e Hosted Connections são connectType=AWSHC.

A implantação do MVE para a AWS inclui estas tarefas:

Pesquisar detalhes de local da AWS

Para criar um VXC para a AWS, primeiro você precisa identificar o productUid da porta à qual deseja se conectar.

Você pode pesquisar locais da AWS para o B-End da conexão com o endpoint v2/dropdowns/partner/megaports.
Criar e implantar um VXC

Com os detalhes da porta identificados, você pode criar o VXC para a AWS a partir do MVE.

Os detalhes de configuração são especificados no Body da solicitação. Algumas das informações principais que você precisa especificar incluem o productUid do MVE, o productUid da porta da AWS e o ID da conta da AWS.

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

Pesquisar detalhes de local da AWS

Use a API para pesquisar o productUid da porta à qual você deseja se conectar. A resposta inclui detalhes das portas disponíveis. Você precisa dos detalhes da porta para criar o VXC.

Na resposta da API, as portas disponíveis que aceitam VXCs são listadas como “vxcPermitted”: true.

Para pesquisar detalhes de local da AWS

Expanda a pasta Locations (Locais) na navegação à esquerda e clique em GET Partner Megaports (Obter Megaports de Parceiros).
Clique em Send (Enviar) para fazer uma solicitação GET ao servidor da API.
```
GET {baseUrl}/v2/dropdowns/partner/megaports
```
Esta solicitação retorna todas as interfaces que a Megaport possui com provedores de serviços de nuvem. Você pode Pesquisar clicando na lupa e inserindo um local, data center ou outro parâmetro no campo de pesquisa.

O connectType indica o Cloud Service Provider. A AWS inclui “AWS” para Hosted VIFs e “AWSHC” para Hosted Connections.

Você pode filtrar os resultados por connectType e vxcPermitted.
```
GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWS&vxcPermitted=true
```
Este exemplo usa uma porta na região eu-west-2 (London) que aceita VXCs (“vxcPermitted”: true).

      {
           "productUid": "b9dcbdca-b73a-4fc9-9ac9-98cecde81ba2",
           "companyUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
           "companyName": "AWS",
           "title": "EU (London) (eu-west-2)",
           "locationId": 90,
           "speed": 10000,
           "maxVxcSpeed": 10000,
           "vxcPermitted": true,
           "diversityZone": null,
           "rank": 378,
           "lag_id": null,
           "lag_primary": false,
           "aggregation_id": null,
           "connectType": "AWS"
      },

Criar e implementar um VXC Hosted VIF

Com os detalhes da porta, crie o VXC para a AWS a partir do MVE.

Você especifica os detalhes de configuração no Body da solicitação. O primeiro productUid identifica o ID do MVE e o bEnd: productUid identifica a localização da porta AWS da consulta de Partner Megaports. Você também precisa fornecer o número da sua conta AWS na solicitação.

Este exemplo usa o tipo de conexão Hosted VIF, connectType=AWS.

Dica

Para testar sua solicitação antes de fazer o pedido e ver detalhes de preços, use o endpoint /v3/networkdesign/validate com a mesma configuração de Body.

Para criar um VXC

Crie uma solicitação com o endpoint POST Buy AWS - Hosted VIF (v3) (POST Comprar AWS - Hosted VIF (v3)):
```
POST {baseUrl}/v3/networkdesign/buy
```
Atualize o Body da solicitação com o productUid do MVE, o nome do VXC, o productUid da porta AWS e o ID da conta AWS (ownerAccount).
Você também pode alterar valores adicionais, como rate limit, prazo do contrato, ID da VLAN, valores de ASN, authKey e endereçamento IP. A vNIC é determinada por vNicIndex, innerVlan identifica o número de VLAN executado dentro da vNIC, neste caso 103.
Nota

O número da vNIC corresponde às seguintes interfaces do MVE:
- vNIC 0 = interface 1 no MVE
- vNIC 1 = interface 2 no MVE
- vNIC 2 = interface 3 no MVE
- vNIC 3 = interface 4 no MVE
- vNIC 4 = interface 5 no MVE
Aqui está um exemplo de solicitação:

[
 {
   "productUid": "{{ mveid }}",
   "associatedVxcs": [
     {
       "productName": "Test AWS VIF MVE VXC",
       "rateLimit": "100",
       "term": 12,
       "shutdown": false,
       "promoCode": "promox3mnthfree2",
       "aEnd": {
       "vNicIndex":2,
       "vlan": null,
         "innerVlan": 103
       },
       "bEnd": {
         "productUid": "{{ awsPortUid }}",
         "partnerConfig": {
           "connectType": "AWS",
           "Name": "Test Megaport",
           "type": "private",
           "asn": 65105,
           "ownerAccount": "XXXXXXXXXXXX",
           "authKey": "123455",
           "customerIpAddress": null,
           "amazonIpAddress": null
         }
       }
     }
   ]
 }
]

Após enviar a solicitação, você receberá uma resposta bem-sucedida quando o VXC tiver sido solicitado.

Aqui está um exemplo de resposta:

{
    "message": "VXC [0d22feee-8d06-4041-98be-5b827c33c78a] created.",
    "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
       {
           "createDate": 1709811450016,
           "vxcOrderId": 139933,
           "payerMegaPortId": 190079,
           "nonPayerMegaPortId": 6199,
           "payerMegaPortName": "MVE for VNIC config",
           "nonPayerMegaPortName": "EU (London) (eu-west-2)",
           "payerCompanyId": 1153,
           "nonPayerCompanyId": 117,
           "payerLocationId": 89,
           "nonPayerLocationId": 89,
           "salesId": null,
           "payerCompanyName": "Megaport Lab",
           "nonPayerCompanyName": "AWS",
           "payerMegaPortNsId": 510708,
           "nonPayerMegaPortNsId": 13055,
           "payerVlanId": 0,
           "nonPayerVlanId": 0,
           "payerInnerVlanId": 103,
           "nonPayerInnerVlanId": null,
           "payerApproverName": "name",
           "payerApproverId": number,
           "nonPayerApproverName": "name",
           "nonPayerApproverId": number,
           "payerApproval": number,
           "nonPayerApproval":number,
           "fixedTerm": true,
           "duration": 1,
           "rollover": true,
           "serviceName": "from MVE for VNIC config to EU (London) (eu-west-2)",
           "payerStatus": "APPROVED",
           "nonPayerStatus": "APPROVED",
           "speed": 100,
           "distanceBand": "METRO",
           "intercapPath": "",
           "awsId": null,
           "promoCode": null,
           "dealUid": null,
           "rateType": "MONTHLY",
           "vxcJTechnicalServiceId": 190085,
           "vxcJTechnicalServiceUid": "0d22feee-8d06-4041-98be-5b827c33c78a",
           "provisionDate": 1709811449985,
           "orderType": "NEW",
           "monthlyDiscountAmount": null,
           "discountMonths": null,
           "amazonDirectConnectConfigDto": {
               "type": "private",
               "asn": 65105,
               "ownerAccount": "aws account ID",
               "authKey": "123455",
               "customerIpAddress": null,
               "amazonIpAddress": null,
               "prefixes": null,
               "name": null
           },
           "amsixConnectConfigDto": null,
           "sdrcProvItem": null,
           "rate": null,
           "setup": null,
           "asn": null,
           "bgpPassword": null,
           "usageAlgorithm": "POST_PAID_HOURLY_SPEED_METRO_VXC",
           "costCentre": null,
           "azureServiceKey": null,
           "oracleVirtualCircuitId": null,
           "serviceKey": null,
           "vxc": {
               "serviceName": "Test AWS VIF MVE VXC",
               "name": "Test AWS VIF MVE VXC",
               "secondaryName": null,
               "technicalServiceId": 190085,
               "technicalServiceUid": "0d22feee-8d06-4041-98be-5b827c33c78a",
               "requestedDate": 1709811449985,
               "configuredDate": null,
               "currentEstimatedDelivery": null,
               "companyName": "Megaport Lab",
               "companyId": 1153,
               "billingContactName": null,
               "billingContactId": null,
               "adminContactName": null,
               "adminContactId": null,
               "technicalContactName": null,
               "technicalContactId": null,
               "salesName": null,
               "salesId": null,
               "billableId": 181633,
               "billableUsageAlgorithm": null,
               "productType": "VXC",
               "provisioningStatus": "DEPLOYABLE",
               "failedReason": null,
               "inAdvanceBillingStatus": null,
               "provisioningItems": [],
               "tags": [],
               "vxcDistanceBand": "METRO",
               "intercapPath": "",
               "marketplaceVisibility": true,
               "vxcPermitted": true,
               "vxcAutoApproval": false,
               "createDate": 1709811450003,
               "terminationDate": null,
               "contractStartDate": null,
               "contractTermMonths": 1,
               "rateType": "MONTHLY",
               "trialAgreement": false,
               "payerCompanyId": null,
               "nonPayerCompanyId": null,
               "minimumSpeed": null,
               "maximumSpeed": null,
               "rateLimit": 100,
               "errorMessage": null,
               "lagId": null,
               "aggregationId": null,
               "lagPrimary": null,
               "market": "UK",
               "accountManager": null,
               "promptUid": null,
               "components": [],
               "attributes": [],
               "aLocation": null,
               "bLocation": null,
               "aMetro": null,
               "aCountry": null,
               "aLocationId": null,
               "bLocationId": null,
               "bMetro": null,
               "bCountry": null,
               "attributeTags": {},
               "createdBy": "b0dedbd2-ecc7-4bad-a13b-6c34b4005115",
               "buyoutPort": null,
               "virtual": false,
               "locked": false,
               "adminLocked": false,
               "bgpShutdownDefault": false,
               "originDomain": null
           },
           "connectType": "AWS",
           "payerConfig": {},
           "nonPayerConfig": {},
           "attributeTags": {},
           "serviceLicense": null,
           "originDomain": null,
           "fullyApproved": true
       }
   ]
}

O VXC agora aparecerá no Megaport Portal.

Para este exemplo, o AWS Hosted VIF aparecerá na conta do portal 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.

Criar e implementar um VXC Hosted Connection

Com os detalhes da porta, crie o VXC para a AWS a partir do MVE.

Você especifica os detalhes de configuração no Body da solicitação. O primeiro productUid identifica o ID do MVE e o bEnd: productUid identifica a localização da porta AWS da consulta de Partner Megaports. Você também precisa fornecer o número da sua conta AWS na solicitação.

Este exemplo usa o tipo de conexão Hosted Connection, connectType=AWSHC.