# Connecter un périphérique Network Edge à un port distant Établissez une connexion non balisée entre votre dispositif virtuel Network Edge et un port Fabric distant à l'aide de [Fabric API](https://docs.equinix.com/fr/api-catalog/fabricv4.md) . ![](https://docs.equinix.com/fr/assets/images/connect-device-to-port-38be28b711622d05580c53afacf60921.png) ## Conditions préalables pour l'API Fabric[​](#conditions-préalables-pour-lapi-fabric "Lien direct vers Conditions préalables pour l'API Fabric") 1. Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr/equinix-api/api-authentication.md). 2. Déterminez vos informations A-Side. Récupérez les informations sur vos dispositifs Network Edge à l'aide de l'outil [obtenir des dispositifs virtuels](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevices.md) ou [obtenir un dispositif virtuel {UUID}](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid.md). Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Cependant, Equinix sélectionnera une interface si vous n'en spécifiez pas. 3. Récupérez les informations de vos ports Equinix Fabric à l'aide de la demande[Get All ports](https://docs.equinix.com/fr/api-catalog/fabricv4/ports/getports.md) API. ## Connexion à un port distant non marqué[​](#connexion-à-un-port-distant-non-marqué "Lien direct vers Connexion à un port distant non marqué") Pour créer une connexion entre un appareil Network Edge et un port distant avec un trafic non balisé, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. > **Note** > > Vous ne pouvez créer qu'une seule connexion non balisée entre un périphérique virtuel Network Edge et un port distant. | | **POST /fabric/v4/connections** | | ---------------------------- | ---------------------------------------------------------------------------------- | | Méthode | `POST` | | Terminal | `/fabric/v4/connections` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | Non applicable | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | `type`, `name`, `order`, `bandwidth`, , `aSide``zSide`, `project`, `notifications` | Exemple de requête 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"             ]         }     ] }' ``` Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . ## Connexion à un port distant du DOT1Q[​](#connexion-à-un-port-distant-du-dot1q "Lien direct vers Connexion à un port distant du DOT1Q") Pour créer une connexion à partir d’un appareil Network Edge vers un port distant DOT1Q, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. Exemple de requête 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"         ]     }     ] }' ``` Exemple de réponse : ``` {     "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": [] } ``` La charge utile de réponse comprend les paramètres de configuration définis dans le corps de la demande. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . ## Connexion à un port distant QinQ[​](#connexion-à-un-port-distant-qinq "Lien direct vers Connexion à un port distant QinQ") Pour créer une connexion entre un appareil Network Edge et un port distant QinQ, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. Exemple de requête 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"         ]     }     ] } ' ``` ## Contrôle de votre connexion[​](#contrôle-de-votre-connexion "Lien direct vers Contrôle de votre connexion") Utilisez le point de terminaison[Get Specified Connection](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/getconnectionbyuuid.md) API pour surveiller l'état de la connexion.