# API - Conecte-se ao IBM Cloud Direct Link no Classic Estabeleça uma conexão com o IBM Cloud™ Direct Link no Classic para conectar seus ativos IBX colocalizados aos seus recursos do IBM Cloud. ![](https://docs.equinix.com/pt-BR/assets/images/connectToIbmDirectLink20-d03a5f72aff4e50771a2f6d848d6952d.jpg) ## Identifique seu ID de conta IBM[​](#identifique-seu-id-de-conta-ibm "Link direto para Identifique seu ID de conta IBM") Faça login no [console do IBM Cloud](https://cloud.ibm.com/login) e selecione *Gerenciar* > *Conta* para localizar o ID da sua conta IBM. ## Pré-requisitos da API Fabric[​](#pré-requisitos-da-api-fabric "Link direto para Pré-requisitos da API Fabric") 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. Obtenha as informações das suas portas Equinix Fabric usando a solicitação[Get All Ports](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/getports.md) API. 3. Escolha o local do mercado estratégico Z-Side. Use a solicitação[Get All Metrôs](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md) API ([Obter todos os](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md) mercados[estratégicos](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md)) para encontrar todos os mercados estratégicos onde o Equinix Fabric está disponível e determinar o local de destino. 4. Identifique o perfil de serviço. Use a solicitação [Recuperar perfis de serviço](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-profiles/searchserviceprofiles.md) API para procurar um perfil de serviço específico ou use a solicitação[Listar perfis de serviço](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-profiles/listserviceprofiles.md) API para listar todos os perfis de[serviço](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-profiles/listserviceprofiles.md) disponíveis e identificar o. perfil ao qual você deseja se conectar. ## Conectando-se ao IBM Cloud Direct Link no Classic a partir de uma porta DOT1Q[​](#conectando-se-ao-ibm-cloud-direct-link-no-classic-a-partir-de-uma-porta-dot1q "Link direto para Conectando-se ao IBM Cloud Direct Link no Classic a partir de uma porta DOT1Q") Para criar uma conexão da porta DOT1Q com o IBM Cloud Direct Link no Classic, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. Especifique os detalhes de configuração da sua conexão no corpo da solicitação. | | **POST /Fabric/v4/Connections** | | ---------------------- | ------------------------------------------------------------------------------------------------------------- | | Método | `POST` | | Ponto de extremidade | `/fabric/v4/connections` | | Cabeçalhos | `Authorization`, `Content-Type` | | Parâmetros do caminho | Não aplicável | | Parâmetros de consulta | Não aplicável | | Parâmetros Corporais | `type``name`, , `order`, `bandwidth`, `redundancy`, , `aSide``zSide`, , `additionalInfo`, , , `notifications` | 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": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ] }' ``` Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. 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 resposta: ``` {     "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "type": "EVPL_VC",     "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "name": "Conn-1",     "state": "PROVISIONING",     "order": {         "purchaseOrderNumber": "1-129105284100",         "billingTier": "Up to 1 Gbps"     },     "bandwidth": 1000,     "redundancy": {         "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",                 "type": "XF_PORT",                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",                 "type": "L2_PROFILE",                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "href": "https://api.equinix.com/v4/metros/SV",                 "metroCode": "SV",                 "region": "AMER"             },             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ],     "operation": {         "equinixStatus": "PROVISIONING",         "providerStatus": "PROVISIONING"     },     "changeLog": {         "createdDateTime": "2021-07-15T19:30:29.526Z"     } } ``` O payload de resposta inclui parâmetros de configuração definidos no corpo da solicitação. Para obter uma lista completa dos parâmetros possíveis e suas descrições, consulte a [Referência API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . ## Conectando-se ao IBM Cloud Direct Link no Classic a partir de uma porta QINQ[​](#conectando-se-ao-ibm-cloud-direct-link-no-classic-a-partir-de-uma-porta-qinq "Link direto para Conectando-se ao IBM Cloud Direct Link no Classic a partir de uma porta QINQ") Para criar uma conexão da sua porta QINQ para o IBM Cloud Direct Link no Classic, envie uma `POST` solicitação para o [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. Especifique os detalhes de configuração da sua conexão no corpo da solicitação. ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{     "type": "EVPL_VC",     "name": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "QINQ",                 "vlanCTag": 1001,                 "vlanSTag": 1002             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ] }' ``` Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. 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) . ## Monitorando o status da conexão[​](#monitorando-o-status-da-conexão "Link direto para Monitorando o 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. | `equinixStatus`valores de atributo | `providerStatus`valores de atributo | Status do **IBM Direct Link** | **Descrição** | | ---------------------------------- | ----------------------------------- | ----------------------------- | ----------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | - | A solicitação de conexão ainda não foi enviada à IBM. | | `PENDING_PROVIDER_VLAN` | `PENDING_APPROVAL` | Criar aprovação pendente | A conexão aguarda aprovação. | | `PROVISIONED` | `PROVISIONING / PROVISIONED` | Criação em andamento | Estabelecimento de conexão em andamento. | | `PROVISIONED` | `PROVISIONED` | Provisionado | Conexão estabelecida. | ## Aceitar a conexão[​](#aceitar-a-conexão "Link direto para Aceitar a conexão") Faça login no [console do IBM Cloud](https://cloud.ibm.com/login) e navegue até a [página do IBM Cloud Direct Link Exchange](https://cloud.ibm.com/classic/network/directlink/exchange) para revisar e aceitar a conexão pendente.