# Migrer la connexion vers un autre appareil virtuel ![](https://docs.equinix.com/fr/assets/images/MigrateConnectionToDifferentVirtualDevice-c2f98589b6a3ad47dc85d71ac39d316b.jpg) ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") 1. Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr/equinix-api/api-authentication.md). 2. Déterminez l'identifiant de connexion existant. Utilisez le point de terminaison[Rechercher les connexions](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/searchconnections.md) pour récupérer une liste de connexions et déterminer l'identifiant de la connexion que vous souhaitez migrer vers un autre port. 3. 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.md)[Virtual](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid.md)[Devices](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevices.md) ou [Get Virtual Device {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. ## Mise à jour de la connexion[​](#mise-à-jour-de-la-connexion "Lien direct vers Mise à jour de la connexion") Pour mettre à jour une connexion et la migrer vers un autre périphérique virtuel, envoyez `PATCH`une demande au noeud final[/Fabric/v4/connections/{ID}](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/updateconnectionbyuuid.md). Dans le corps de la demande, spécifiez l'identifiant a-side de la connexion au dispositif virtuel vers lequel vous migrez la connexion. | | **PATCH /fabric/v4/connections/{uuid}** | | ---------------------------- | --------------------------------------- | | Méthode | PATCH | | URL ou point final | `/fabric/v4/connections/{uuid}` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | `uuid` | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | op, chemin, valeur | Pour valider en toute sécurité cette demande en production sans modifier les connexions, 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 PATCH 'https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62' -H 'content-type: application/json-patch+json' -H 'authorization: Bearer ' -d '[     {         "op": "replace",         "path": "/aSide/accessPoint",         "value": {             "type": "VD",             "virtualDevice": {                 "type": "EDGE",                 "uuid": "e8b49cd7-9b4c-4123-8bd4-fbead83c3436"             },             "interface": {                 "type": "NETWORK",                 "id": 5             }         }     } ]' ``` **Paramètres de chemin** | **Paramètre** | **Obligatoire** | **Type** | **Exemple** | **Valeurs applicables** | **Description** | | ------------- | --------------- | -------- | ------------------------------------ | ----------------------- | ---------------------------------------------- | | uuid | oui | chaîne | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Identifiant de connexion attribué par Equinix. | **Paramètres du corps** | **Paramètre** | **Obligatoire** | **Type** | **Exemple** | **Valeurs applicables** | **Description** | | ---------------- | --------------- | -------- | ------------------------------------ | ----------------------- | ------------------------------------------- | | op | oui | chaîne | remplacer | remplacer | Type de demande de mise à jour. | | chemin | oui | chaîne | /Aide/AccessPoint | /Aide/AccessPoint | Chemin des paramètres. | | Valeur | oui | objet | | - | | | type | oui | chaîne | VD | VD | VD - Virtual Device (appareil virtuel). | | appareil virtuel | oui | objet | | - | Détails de l'appareil virtuel. | | type | oui | chaîne | EDGE | EDGE | EDGE. | | uuid | oui | chaîne | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | | Identité unique du nouvel appareil virtuel. | | interface | non | objet | | | Détails de l'interface. | | type | non | chaîne | Réseau | | RÉSEAU. | | ID | non | entier | 5 | | Interface de l'appareil virtuel. | Exemple de réponse : ``` {     "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "type": "EVPL_VC",     "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "name": "Conn-Name-2",     "state": "PROVISIONED",     "order": {         "purchaseOrderNumber": "1-129105284100",         "billingTier": "Up to 1 Gbps"     },     "bandwidth": 1000,     "redundancy": {         "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",         "priority": "PRIMARY"     },     “aSide”: {         “accessPoint”: {             "interface": {                 “uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",                 “id”: 7,                 “type”: "NETWORK"             },             “location”: {                 “metroCode”: "AM"             },             “virtualDevice”: {                 “uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXX",                  “type”: "EDGE"             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",                 "type": "L2_Profile",                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"             },             "location": {                 "href": "https://api.equinix.com/v4/metros/SV",                 "metrocode": "SV",                 "region": "AMER"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@equinix.com"             ]         }     ],     "operation": {         "equinixStatus": "PROVISIONED",         "providerStatus": "PROVISIONED"     },     "changeLog": {         "createdDateTime": "2021-07-15T19:30:29.526Z",         "updatedDateTime": "2021-08-15T19:30:29.526Z",     } } ```