# API - Conectando-se ao AWS Direct Connect Com Fabric e AWS Direct Connect, estabeleça uma conexão direta de camada 2 entre seus ativos colocated IBX e seus recursos Amazon Web Services (AWS). Use o API para criar a conexão a partir de uma porta, dispositivo Network Edge ou Fabric Cloud Router. ![](https://docs.equinix.com/pt-BR/assets/images/connectToAWS-e4d5112e10b97bf9a1a7d753bf90b11b.png) Se você tiver um token de serviço fornecido pela AWS, consulte [Conectar-se a um destino usando um token de serviço](https://docs.equinix.com/pt-BR/fabric/fabric-api/connect-using-service-token.md) . ## Pré-requisitos da API[​](#pré-requisitos-da-api "Link direto para Pré-requisitos da API") 1. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. 2. Determine suas informações do A-Side. Ou: * Para determinar as informações das suas portas Equinix Fabric, envie uma `GET` solicitação ao [`/fabric/v4/ports`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/getports.md)terminal. Você precisa do(s) UUID(s) da porta e do tipo de protocolo de link (DOT1Q ou QINQ), OU * Recupere seu token de serviço A-Side ou tokens enviando uma `GET` solicitação ao [`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)endpoint. Você precisa do UUID do token. O token A-Side fornece as informações relevantes para configurar o A-Side da conexão. OU * Determine as informações do seu dispositivo Network Edge. Verifique seus dispositivos virtuais e clusters disponíveis enviando uma `GET` solicitação para o [`/ne/v1/devices`](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevices) terminal. Você precisa do(s) UUID(s) do dispositivo. Envie uma `GET` solicitação para o [`/ne/v1/devices/{device_id}`](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid) terminal para obter as especificações de um dispositivo. Você pode escolher qualquer interface disponível no dispositivo para sua conexão. Se você não especificar uma, a conexão será atribuída automaticamente à próxima interface disponível. OU * Determine suas informações de Fabric Cloud Router. Verifique seus roteadores de cloud disponíveis enviando uma `POST` solicitação para o [`/fabric/v4/routers/search`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md) terminal. Você precisa do UUID do roteador. 3. Identifique o perfil de serviço AWS Direct Connect e as informações de localização. Para obter mais informações sobre o perfil de serviço que você deve escolher, consulte a página[Visão geral do AWS Direct Connect](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/aws/direct-connect-overview.md). * UUID do AWS Direct Connect - `69ee618d-be52-468d-bc99-00566f2dd2b9` * UUID de alta capacidade AWS Direct Connect - `de55ca94-df3b-4680-845f-6f7093f76bef` * UUID redundante AWS Direct Connect - `8b5cbdbd-53da-4d37-9bfc-cc988eb522f1` * AWS Direct Connect- Redundante de alta capacidade - `ed48616a-c182-40b4-a462-a78ba812e961` Para encontrar as informações de localização, envie uma `GET` solicitação ao [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal usando um dos IDS de perfil de serviço AWS Direct Connect. O `metros` objeto na resposta contém uma lista de mercados estratégicos Equinix e sua região AWS associada. Você precisa de ambos para criar uma conexão. 4. Identifique e valide o ID da sua conta Amazon. Faça login no AWS Management Console e localize o número da sua conta. Consulte [a documentação do AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) para obter instruções sobre como encontrar o número da sua conta. Envie uma `POST` solicitação ao [`/fabric/v4/connections/validate`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/validateconnections.md)terminal para verificar se o ID da sua conta AWS pode ser usado para criar uma conexão com o perfil de serviço selecionado no mercado estratégico específico. ## Conexão de uma Porta DOT1Q[​](#conexão-de-uma-porta-dot1q "Link direto para Conexão de uma Porta DOT1Q") Para criar uma conexão da porta DOT1Q para o AWS, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça suas informações de porta no `aSide`objeto, incluindo: * `accessPoint.type` como `COLO` * Forneça o UUID da sua porta para `port.uuid` * LinkProtocol.type como `DOT1Q` * Forneça o ID do VLAN para `linkProtocol.vlanTag` Forneça os detalhes do AWS Direct Connect e os detalhes de localização no `zSide`objeto, incluindo: * Definir `accessPoint.type` como `SP`. * Definir `profile.type` como `L2_PROFILE`. * Especifique o perfil de serviço AWS ao qual você está se conectando no `profile.uuid`. * Especifique o local estratégico da Equinix ao qual você está se conectando em `location.metroCode`. * Especifique a região do AWS associada ao mercado estratégico de Equinix em `sellerRegion`. Essas informações podem ser encontradas no [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal. Consulte o endpoint de[pré-requisitos do API](#api-prerequisites). Consulte [Pré-requisitos do API](#api-prerequisites) para obter detalhes. * Defina `authenticationKey` como seu ID de conta AWS. Especifique quaisquer outros detalhes de configuração da conexão, incluindo `bandwidth` e `redundancy`, no corpo da solicitação. Para obter uma lista completa de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": {      "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {         "type": "DOT1Q",         "vlanTag":       }     }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Conectando de uma Porta QINQ[​](#conectando-de-uma-porta-qinq "Link direto para Conectando de uma Porta QINQ") Para criar uma conexão da sua porta QINQ para o AWS, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça suas informações de porta no `aSide`objeto, incluindo: * Definir `accessPoint.type` como `COLO` * Forneça o UUID da sua porta para `port.uuid` * `linkProtocol.type` como `QINQ` * Forneça o ID da tag interna para `linkProtocol.vlanCTag` * Forneça o ID da tag externa para `linkProtocol.vlanSTag` Forneça os detalhes do AWS Direct Connect e os detalhes de localização no `zSide`objeto, incluindo: * Definir `accessPoint.type` como `SP`. * Definir `profile.type` como `L2_PROFILE`. * Especifique o perfil de serviço AWS ao qual você está se conectando no `profile.uuid`. * Especifique o local estratégico da Equinix ao qual você está se conectando em `location.metroCode`. * Especifique a região do AWS associada ao mercado estratégico de Equinix em `sellerRegion`. Essas informações podem ser encontradas no [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal. Consulte o endpoint de[pré-requisitos do API](#api-prerequisites). Consulte [Pré-requisitos do API](#api-prerequisites) para obter detalhes. * Defina `authenticationKey` como seu ID de conta AWS. Especifique quaisquer outros detalhes de configuração da conexão, incluindo `bandwidth` e `redundancy`, no corpo da solicitação. Para obter uma lista completa de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": { "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {        "type": "QINQ",         "vlanCTag": ,         "vlanSTag":       } }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Conexão usando um token de serviço[​](#conexão-usando-um-token-de-serviço "Link direto para Conexão usando um token de serviço") Para criar uma conexão usando um token de serviço A-Side para o AWS, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça o UUID do token de serviço para no `aSide`objeto. O token de serviço fornece todas as outras informações necessárias para estabelecer a conexão. Forneça os detalhes do AWS Direct Connect e os detalhes de localização no `zSide`objeto, incluindo: * Definir `accessPoint.type` como `SP`. * Definir `profile.type` como `L2_PROFILE`. * Especifique o perfil de serviço AWS ao qual você está se conectando no `profile.uuid`. * Especifique o local estratégico da Equinix ao qual você está se conectando em `location.metroCode`. * Especifique a região do AWS associada ao mercado estratégico de Equinix em `sellerRegion`. Essas informações podem ser encontradas no [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal. Consulte o endpoint de[pré-requisitos do API](#api-prerequisites). Consulte [Pré-requisitos do API](#api-prerequisites) para obter detalhes. * Defina `authenticationKey` como seu ID de conta AWS. Especifique quaisquer outros detalhes de configuração da conexão, incluindo `bandwidth` e `redundancy`, no corpo da solicitação. Para obter uma lista completa de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "serviceToken": { "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Conexão de um dispositivo de Network Edge[​](#conexão-de-um-dispositivo-de-network-edge "Link direto para Conexão de um dispositivo de Network Edge") Para criar uma conexão do seu dispositivo Network Edge com o AWS, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Defina seu dispositivo Network Edge no `aSide` objeto, incluindo: * `accessPoint.type` as `VD` * `virtualDevice.type` como `EDGE` * `virtualDevice.uuid` Como UUID do seu dispositivo Forneça os detalhes do AWS Direct Connect e os detalhes de localização no `zSide`objeto, incluindo: * Definir `accessPoint.type` como `SP`. * Definir `profile.type` como `L2_PROFILE`. * Especifique o perfil de serviço AWS ao qual você está se conectando no `profile.uuid`. * Especifique o local estratégico da Equinix ao qual você está se conectando em `location.metroCode`. * Especifique a região do AWS associada ao mercado estratégico de Equinix em `sellerRegion`. Essas informações podem ser encontradas no [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal. Consulte o endpoint de[pré-requisitos do API](#api-prerequisites). Consulte [Pré-requisitos do API](#api-prerequisites) para obter detalhes. * Defina `authenticationKey` como seu ID de conta AWS. Especifique quaisquer outros detalhes de configuração da conexão, incluindo `bandwidth` e `redundancy`, no corpo da solicitação. Para obter uma lista completa de parâmetros e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Conexão a partir de um Fabric Cloud Router[​](#conexão-a-partir-de-um-fabric-cloud-router "Link direto para Conexão a partir de um Fabric Cloud Router") Para criar uma conexão do seu Fabric Cloud Router para o AWS, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `IP_VC`. Defina seu Fabric Cloud Router no `aSide`objeto, incluindo: * Definir `accessPoint.type` como `CLOUD_ROUTER`. * Defina `router.uuid` como UUID do seu roteador. Forneça os detalhes do AWS Direct Connect e os detalhes de localização no `zSide`objeto, incluindo: * Definir `accessPoint.type` como `SP`. * Definir `profile.type` como `L2_PROFILE`. * Especifique o perfil de serviço AWS ao qual você está se conectando no `profile.uuid`. * Especifique o local estratégico da Equinix ao qual você está se conectando em `location.metroCode`. * Especifique a região do AWS associada ao mercado estratégico de Equinix em `sellerRegion`. Essas informações podem ser encontradas no [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)terminal. Consulte o endpoint de[pré-requisitos do API](#api-prerequisites). Consulte [Pré-requisitos do API](#api-prerequisites) para obter detalhes. * Defina `authenticationKey` como seu ID de conta AWS Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "IP_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "CLOUD_ROUTER", "router": { "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Monitoramento do status da conexão[​](#monitoramento-do-status-da-conexão "Link direto para Monitoramento do status da conexão") Envie uma `GET` solicitação ao [`fabric/v4/connections/{connection_id}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md)terminal para monitorar o status da conexão. | `equinixStatus` valores de atributo | `providerStatus` valores de atributo | **Estado do AWS Direct Connect** | **Descrição** | | ----------------------------------- | ------------------------------------ | -------------------------------- | ---------------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | | A solicitação de conexão ainda não foi enviada para a AWS. | | `PROVISIONED` | `PENDING_APPROVAL` | Pedido -> Solicitado | A conexão aguarda aceitação. | | `PROVISIONED` | `PROVISIONING` | Pendente | Estabelecimento de conexão em andamento. | | `PROVISIONED` | `PROVISIONED` | Pendente -> Disponível | A conexão foi aceita. |