# API - Conectar ao Microsoft Azure ExpressRoute Estabeleça uma conexão direta de camada 2 com o Microsoft Azure para acessar a Infraestrutura de Nuvem do Azure e outros serviços de Nuvem do Azure. ![](https://docs.equinix.com/pt-BR/assets/images/connectToMicrosoftAzure-7cbea56c79acbe0302b172a682b43b7e.jpg) > **Observação** > > Este documento aborda a criação de uma conexão a partir de uma porta, token de serviço ou roteador de cloud no API. Para obter informações sobre como criar uma conexão a partir de um dispositivo virtual, inclusive no API, consulte [Network Edge to Azure ExpressRoute](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md) ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 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 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 as informações do perfil de serviço do Azure ExpressRoute. Para obter mais informações sobre o perfil de serviço que você deve escolher, consulte a página[Visão geral do Azure ExpressRoute](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#azure-express-route-service-profiles). * Azure ExpressRoute - `a1390b22-bbe0-4e93-ad37-85beef9d254d` * Azure Government ExpressRoute - `0de4e413-edd7-4325-912f-7c8a4428e156` 4. Identifique e valide sua chave de serviço do ExpressRoute. 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 sua chave de serviço ExpressRoute pode ser usada 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 Azure ExpressRouter, 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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Defina `authenticationKey` como sua chave de serviço do ExpressRoute . * Defina `peeringType` como `MICROSOFT` ou `PRIVATE`, dependendo dos serviços para os quais você está usando a conexão. Para obter mais informações, consulte [Configurando peering](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Defina `linkProtocol.type` como `QINQ` e especifique um `linkProtocol.vlanCTag`. Isso define o ID VLAN do ExpressRoute usado para peering. Você também pode definir esse valor no portal do Azure depois de criar a conexão. 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": "DC" }, "linkProtocol": { "type": "QINQ", "vlanCTag": }, "peeringType": "", "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 porta DOT1Q para o Azure ExpressRouter, 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 `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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Defina `authenticationKey` como sua chave de serviço do ExpressRoute . * Defina `peeringType` como `MICROSOFT` ou `PRIVATE`, dependendo dos serviços para os quais você está usando a conexão. Para obter mais informações, consulte [Configurando peering](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Defina `linkProtocol.type` como `QINQ` e especifique um `linkProtocol.vlanCTag`. Isso define o ID VLAN do ExpressRoute usado para peering. Você também pode definir esse valor no portal do Azure depois de criar a conexão. 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", "vlanSTag": , "vlanCTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 da porta DOT1Q para o Azure ExpressRouter, 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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Defina `authenticationKey` como sua chave de serviço do ExpressRoute . * Defina `peeringType` como `MICROSOFT` ou `PRIVATE`, dependendo dos serviços para os quais você está usando a conexão. Para obter mais informações, consulte [Configurando peering](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Defina `linkProtocol.type` como `QINQ` e especifique um `linkProtocol.vlanCTag`. Isso define o ID VLAN do ExpressRoute usado para peering. Você também pode definir esse valor no portal do Azure depois de criar a conexão. 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": "" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 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` é `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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Defina `authenticationKey` como sua chave de serviço do ExpressRoute . * Defina `peeringType` como `MICROSOFT` ou `PRIVATE`, dependendo dos serviços para os quais você está usando a conexão. Para obter mais informações, consulte [Configurando peering](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Defina `linkProtocol.type` como `QINQ` e especifique um `linkProtocol.vlanCTag`. Isso define o ID VLAN do ExpressRoute usado para peering. Você também pode definir esse valor no portal do Azure depois de criar a conexão. 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) . ``` 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": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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/{connectionId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md)terminal para monitorar o status da conexão. | Estados de conexão Equinix | | Estados do Azure | | | | --------------------------------------- | ---------------------------------------- | ---------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`equinixStatus`** valores de atributo | **`providerStatus`** valores de atributo | **Status do provedor** | **Status dos Peerings** | **Descrição** | | `PROVISIONING` | `PROVISIONING` | Não provisionado | Não provisionado | A solicitação de conexão ainda não foi enviada à Microsoft. | | `PENDING_BGP_PEERING` | `PENDING_BGP` | Provisionado | Não provisionado | A conexão foi aprovada e aguarda que o cliente configure o peering da Microsoft no portal Microsoft Azure. Se você estiver se conectando ao Azure ExpressRoute a partir de uma porta, o status permanecerá `PENDING_BGP_PEERING` até que o peering seja concluído no portal Microsoft Azure e o status só mude para `PROVISIONED` quando o Equinix Fabric sincronizar com a Microsoft. Se você quiser sincronizar o peering BGP instantaneamente, use o endpoint API[Ações de conexão](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnectionaction.md). Se você estiver se conectando ao Azure ExpressRoute a partir de um Fabric Cloud Router, também precisará [configurar seus detalhes de roteamento](https://docs.equinix.com/pt-BR/fabric-cloud-router/bgp/fcr-bgp.md) para a conexão no Equinix Customer Portal. | | `PROVISIONING` | `PROVISIONED` | | | O provisionamento foi concluído na Microsoft e a conexão está sendo provisionada na Equinix. | | `PROVISIONED` | `PROVISIONED` | | | Conexão estabelecida. |