# Se connecter à un réseau Établir une connexion directe et à faible latence entre vos réseaux et vos ports et appareils virtuels. ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") 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. Obtenir les informations sur votre réseau Fabric : envoyez une `POST` demande au [`fabric/v4/networks/search`](https://docs.equinix.com/fr/api-catalog/fabricv4/networks/searchnetworks.md)terminal pour rechercher et récupérer une liste de vos réseaux disponibles. 3. Déterminez les informations relatives au port ou à l'appareil virtuel. * Récupérez les informations de vos ports Equinix Fabric à l'aide du point de terminaison[obtenir tous les ports](https://docs.equinix.com/fr/api-catalog/fabricv4/ports/getports.md). Pour trouver des informations sur un port spécifique, utilisez le point de terminaison[obtenir le port spécifié](https://docs.equinix.com/fr/api-catalog/fabricv4/ports/getportbyuuid.md). * Déterminez les informations relatives à votre appareil Network Edge. Vous avez besoin d'un dispositif virtuel Equinix/de dispositifs redondants/de clusters provisionnés avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant [Get](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevices)[Virtual](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)[Devices](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevices) ou [Get Virtual Device {UUID}](https://docs.equinix.com/fr/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. ## Création d'une connexion entre un port balisé et un réseau EVPLAN[​](#création-dune-connexion-entre-un-port-balisé-et-un-réseau-evplan "Lien direct vers Création d'une connexion entre un port balisé et un réseau EVPLAN") Pour créer une connexion entre un port balisé et un réseau EVPLAN, 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. | | **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`, `notifications`, redondance | Pour valider en toute sécurité cette demande en production sans créer de connexion, voir [test en production (API à sec)](https://docs.equinix.com/fr/equinix-api/testing/testing-in-production-dry-run.md). 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": "EVPLAN_VC",   "name": "MY-EVPLAN-CONNECTION-1",   "bandwidth": 1000,   "aSide": {     "accessPoint": {       "type": "COLO",       "port": {         "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"       },       "linkProtocol": {         "type": "DOT1Q",         "vlanTag": 300       }     }   },   "zSide": {     "accessPoint": {       "type": "NETWORK",       "network": {         "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"       }     }   },   "order": {     "purchaseOrderNumber": "1-129105284100"   },   "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) . Exemple de réponse : ``` { "type": "EVPLAN_VC", "href": "https://uat2api.npclouda.equinix.com/fabric/v4/connections/01df5124-eed1-4a30-89bb-240c33d5cd12", "uuid": "01df5124-eed1-4a30-89bb-240c33d5cd12", "name": "test2", "operation": {     "providerStatus": "NOT_AVAILABLE",     "equinixStatus": "PROVISIONING" }, "order": {     "billingTier": "Up to 50 MB" }, "notifications": [     {     "type": "ALL",     "emails": [         "1eqxnfvuser1@equinix.com"     ]     } ], "changeLog": {     "createdBy": "eqxnfvuser1",     "createdByFullName": "eqxnfvuser eqxnfvuser",     "createdByEmail": "1eqxnfvuser1@equinix.com",     "createdDateTime": "2023-03-27T18:29:53.117Z",     "updatedBy": "eqxnfvuser1",     "updatedByFullName": "eqxnfvuser eqxnfvuser",     "updatedByEmail": "1eqxnfvuser1@equinix.com",     "updatedDateTime": "2023-03-27T18:29:53.117Z" }, "bandwidth": 50, "redundancy": {     "priority": "PRIMARY",     "group": "7a58dd05-f46d-4b1d-a154-2e85c396ea63" }, "aSide": {     "accessPoint": {     "location": {         "metroCode": "DC"     },     "port": {         "type": "XF_PORT",         "href": "https://uat2api.npclouda.equinix.com/fabric/v4/ports/e569f0bb-96d5-6d5e-92e0-387a5c00a379",         "uuid": "e569f0bb-96d5-6d5e-92e0-387a5c00a379",         "name": "eqx-nfv-DC5-L-Dot1q-STD-Pri-1G-JP-2"     },     "linkProtocol": {         "type": "DOT1Q",         "vlanTag": 44     }     } }, "zSide": {     "accessPoint": {     "network": {         "href": "https://uat2api.npclouda.equinix.com/fabric/v4/networks/ecc81fe0-7a96-4e08-94f2-0ab52fae662b",         "uuid": "ecc81fe0-7a96-4e08-94f2-0ab52fae662b",         "name": "EVPLAN-AMER-1",         "platformUuid": "52c6ec8b-4aad-4167-be6d-1972a12d1b83",         "state": "ACTIVE",         "type": "EVPLAN",         "scope": "REGIONAL",         "location": {         "region": "AMER"         }     }     } } } ``` 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) . ## Création d'une connexion entre un port non marqué et un réseau EPLAN[​](#création-dune-connexion-entre-un-port-non-marqué-et-un-réseau-eplan "Lien direct vers Création d'une connexion entre un port non marqué et un réseau EPLAN") Pour créer une connexion entre un port non balisé et un réseau EPLAN, 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. ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d ' {   "type": "EPLAN_VC",   "name": "MY-EPLAN-CONNECTION-1",   "bandwidth": 1000,   "aSide": {     "accessPoint": {       "type": "COLO",       "port": {         "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"       }     }   },   "zSide": {     "accessPoint": {       "type": "NETWORK",       "network": {         "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"       }     }   },   "order": {     "purchaseOrderNumber": "1-129105284100"   },   "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) . ## Création d'une connexion entre un appareil virtuel et le réseau EVPLAN[​](#création-dune-connexion-entre-un-appareil-virtuel-et-le-réseau-evplan "Lien direct vers Création d'une connexion entre un appareil virtuel et le réseau EVPLAN") Pour créer une connexion entre un appareil virtuel et un réseau EVPLAN, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point de terminaison. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d ' {   "type": "EVPLAN_VC",   "name": "MY-VD-EVPLAN-CONNECTION-1",   "bandwidth": 1000,   "aSide": {     "accessPoint": {       "type": "VD",       "virtualDevice": {         "type": "EDGE",         "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"       },       "interface": {         "type": "NETWORK",         "id": 7       }     }   },   "zSide": {     "accessPoint": {       "type": "NETWORK",       "network": {         "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"       }     }   },   "order": {     "purchaseOrderNumber": "1-129105284100"   },   "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) .