# Conecte o dispositivo de Network Edge à porta remota Estabeleça uma conexão desmarcada entre seu dispositivo virtual Network Edge e uma porta Fabric remota usando o [Fabric API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4.md) . ![](https://docs.equinix.com/pt-BR/assets/images/connect-device-to-port-38be28b711622d05580c53afacf60921.png) ## 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 dos seus dispositivos Network Edge usando [Obter dispositivos virtuais](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevices) ou [Obter dispositivo virtual (uuid)](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). Você pode escolher qualquer interface disponível no dispositivo para sua conexão. No entanto, o Equinix selecionará uma interface se você não especificar uma. 3. 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. ## Conectando a uma Porta remota não marcada[​](#conectando-a-uma-porta-remota-não-marcada "Link direto para Conectando a uma Porta remota não marcada") Para criar uma conexão de um dispositivo Network Edge para uma porta remota com tráfego não marcado, 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. > **Observação** > > Você pode criar apenas uma única conexão não marcada de um dispositivo virtual do Network Edge para uma porta remota. | | **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`, `aSide`, , `zSide``project`, , `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",     "bandwidth": 100,     "redundancy": {         "priority": "PRIMARY"     },     "name": "ConnectionName-1",     "order": {         "purchaseOrderNumber": "1-3232923"     },     "aSide": {         "accessPoint": {             "type": "VD",             "virtualDevice": {                 "type": "EDGE",                 "uuid": "fd5342f3-d067-4683-a24f-be952279630b"             },             "interface": {                 "type": "NETWORK",                 "id": 45645             }         }     },     "zSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"             },             "linkProtocol": {                 "type": "UNTAGGED"             }         }     },     "project": {         "projectId": 567     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test1@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) . ## Conectando a uma Porta remota DOT1Q[​](#conectando-a-uma-porta-remota-dot1q "Link direto para Conectando a uma Porta remota DOT1Q") Para criar uma conexão de um dispositivo Network Edge para uma porta remota DOT1Q, 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. 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",     "bandwidth": 1000,     "name": "vd to COLO",     "aSide": {     "accessPoint": {         "type": "VD",         "virtualDevice": {         "type": "EDGE",         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "interface": {         "type": "NETWORK",         "id": 45645         }     }     },     "zSide": {     "accessPoint": {         "type": "COLO",         "port": {         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "linkProtocol": {         "type": "DOT1Q",         "vlanTag": 300         }     }     },     "order": {     "purchaseOrderNumber": "1-129105284100"     },     "notifications": [     {         "type": "ALL",         "emails": [         "test@equinix.com",         "test1@equinix.com"         ]     }     ] }' ``` Exemplo de resposta: ``` {     "type": "EVPL_VC",     "href": "https://api.equinix.com/fabric/v4/connections/c193c1c4-2c7e-472d-8c91-0283bc3b5a71",     "uuid": "c193c1c4-2c7e-472d-8c91-0283bc3b5a71",     "name": "ConnectionName-1",     "state": "PROVISIONING",     "operation": {         "providerStatus": "NOT_AVAILABLE",         "equinixStatus": "PROVISIONING"     },     "order": {         "purchaseOrderNumber": "1-3232923"     },     "project": {         "projectId": 567     },     "notifications": [         {             "type": "ALL",             "emails": [                 "testqq@equinix.com"             ]         }     ],     "account": {         "accountNumber": 270217,         "orgId": 92287,         "globalOrgId": "0016u000003JZ53AAG"     },     "changeLog": {         "createdBy": "eqxnfvuser",         "createdDateTime": "2022-03-22T23:14:23.546Z"     },     "bandwidth": 100,     "redundancy": {         "group": "79a0e626-55fe-4fe1-89a5-4d7ca52214db",         "priority": "PRIMARY"     },     "isRemote": true,     "direction": "INTERNAL",     "aSide": {         "accessPoint": {             "interface": {                 "uuid": "bf8a606b-32b2-4a53-a450-6eabd7d9ccab",                 "id": 45645,                 "type": "CLOUD"             },             "type": "VD",             "account": {                 "accountNumber": 270217,                 "orgId": 92287,                 "organizationName": "eqx-nfv",                 "globalOrgId": "0016u000003JZ53AAG"             },             "location": {                 "href": "https://api.equinix.com/fabric/v4/metros/DC",                 "region": "AMER",                 "metroName": "Ashburn",                 "metroCode": "DC"             },             "virtualDevice": {                 "href": "https://api.equinix.com/ne/v1/devices/fd5342f3-d067-4683-a24f-be952279630b",                 "uuid": "fd5342f3-d067-4683-a24f-be952279630b",                 "name": "ha-json",                 "type": "EDGE"             }         }     },     "zSide": {         "accessPoint": {             "type": "COLO",             "account": {                 "accountNumber": 270224,                 "orgId": 92287,                 "organizationName": "eqx-nfv",                 "globalOrgId": "0016u000003JZ53AAG"             },             "location": {                 "href": "https://api.equinix.com/fabric/v4/metros/SY",                 "region": "APAC",                 "metroName": "Sydney",                 "metroCode": "SY"             },             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5d73-d730-8ce0-306a5c00a4ee",                 "uuid": "c791f8cb-5d73-d730-8ce0-306a5c00a4ee",                 "name": "eqx-nfv-SY1-L-Dot1q-BO-PRI-10G-JN-1147"             },             "linkProtocol": {                 "type": "DOT1Q"             }         }     },     "additionalInfo": [] } ``` 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 a uma Porta remota QinQ[​](#conectando-a-uma-porta-remota-qinq "Link direto para Conectando a uma Porta remota QinQ") Para criar uma conexão de um dispositivo Network Edge para uma porta remota QinQ, 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. 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",     "bandwidth": 1000,     "name": "vd to COLO",     "aSide": {     "accessPoint": {         "type": "VD",         "virtualDevice": {         "type": "EDGE",         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "interface": {         "type": "NETWORK",         "id": 45645         }     }     },     "zSide": {     "accessPoint": {         "type": "COLO",         "port": {         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "linkProtocol": {         "type": "QINQ",         "vlanSTag": 300,         "vlanCTag": 400         }     }     },     "order": {     "purchaseOrderNumber": "1-129105284100"     },     "notifications": [     {         "type": "ALL",         "emails": [         "test@equinix.com",         "test1@equinix.com"         ]     }     ] } ' ``` ## Monitorando sua conexão[​](#monitorando-sua-conexão "Link direto para Monitorando sua conexão") Use o ponto de extremidade[Get Specified Connection](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md) API para monitorar o status da conexão.