Migrer la connexion vers un autre périphérique 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 de terminaison | /fabric/v4/connections/{uuid} |
| En-têtes | Authorization, Content-Type |
| Paramètres du chemin | uuid |
| Paramètres de requête | Non applicable |
| Paramètres corporels | 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 | Mettre à jour le type de demande. |
| chemin | oui | chaîne | /Aide/AccessPoint | /Aide/AccessPoint | Chemin du paramètre. |
| Valeur | oui | objet | - | ||
| type | oui | chaîne | VD | VD | VD - Périphérique virtuel. |
| appareil virtuel | oui | objet | - | Détails du périphérique virtuel. | |
| type | oui | chaîne | BORD | BORD | BORD. |
| uuid | oui | chaîne | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | Identifiant unique du nouveau périphérique virtuel. | |
| interface | Non | objet | Détails de l'interface. | ||
| type | Non | chaîne | RÉSEAU | RÉSEAU. | |
| ID | Non | entier | 5 | Interface du périphérique 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",
}
}