Migrer la connexion vers un autre appareil virtuel

Conditions préalables
-
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.
-
Déterminez l'identifiant de connexion existant. Utilisez le point de terminaisonRechercher les connexions pour récupérer une liste de connexions et déterminer l'identifiant de la connexion que vous souhaitez migrer vers un autre port.
-
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 GetVirtualDevices ou Get Virtual Device {UUID}. 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
Pour mettre à jour une connexion et la migrer vers un autre périphérique virtuel, envoyez PATCHune demande au noeud final/Fabric/v4/connections/{ID}. 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).
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 <token>'
-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",
}
}