# Connecter le périphérique Network Edge au 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-CA/api-catalog/fabricv4.md) . ![](https://docs.equinix.com/fr-CA/assets/images/connect-device-to-port-38be28b711622d05580c53afacf60921.png) ## Prérequis de l'API Fabric[​](#prérequis-de-lapi-fabric "Lien direct vers Prérequis de l'API Fabric") 1. Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète 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-CA/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-CA/api-catalog/network-edgev1/virtual-device/getvirtualdevices) ou [obtenir un dispositif virtuel {UUID}](https://docs.equinix.com/fr-CA/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). 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-CA/api-catalog/fabricv4/ports/getports.md) API. ## Connexion à un port distant non balisé[​](#connexion-à-un-port-distant-non-balisé "Lien direct vers Connexion à un port distant non balisé") 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-CA/api-catalog/fabricv4/connections/createconnection.md)point final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. > **Remarque** > > Vous ne pouvez créer qu'une seule connexion non balisée à partir d'un périphérique virtuel Network Edge vers un port distant. | | **POST /fabric/v4/connections** | | --------------------- | ---------------------------------------------------------------------------------- | | Méthode | `POST` | | Terminal | `/fabric/v4/connections` | | En-têtes | `Authorization`, `Content-Type` | | Paramètres du chemin | Non applicable | | Paramètres de requête | Non applicable | | Paramètres corporels | `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-CA/api-catalog/fabricv4/connections/createconnection.md) . ## Connexion à un port distant DOT1Q[​](#connexion-à-un-port-distant-dot1q "Lien direct vers Connexion à un port distant 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-CA/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-CA/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-CA/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"         ]     }     ] } ' ``` ## Surveiller votre connexion[​](#surveiller-votre-connexion "Lien direct vers Surveiller votre connexion") Utilisez le point de terminaison[Get Specified Connection](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/getconnectionbyuuid.md) API pour surveiller l'état de la connexion.