Migrer la connexion vers un autre périphérique virtuel
Conditions préalables
-
Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.
-
Déterminez l'ID de la connexion existante. Utilisez le point de terminaison Search Connections pour récupérer une liste de connexions et déterminer l'ID de la connexion que vous souhaitez migrer vers un port différent.
-
Identifiez les renseignements relatifs à votre appareil Network Edge. Vous avez besoin d'un périphérique virtuel/d'un périphérique redondant/d'une grappe Equinix provisionnée et disposant d'une licence enregistrée. Consultez la liste des périphériques virtuels et des grappes disponibles en appelant Get Virtual Devices ou Get Virtual Device {uuid}. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Toutefois, Equinix choisira une interface par défaut.
Mise à jour de la connexion
Pour mettre à jour une connexion et la migrer vers un autre périphérique virtuel, envoyez une requête PATCH au point de terminaison /fabric/v4/connections/{id}. Spécifiez l'identifiant côté serveur de la connexion vers le périphérique virtuel de destination dans le corps de la requête.
| PATCH /fabric/v4/connections/{uuid} | |
|---|---|
| Method | PATCH |
| URL or Endpoint | /fabric/v4/connections/{uuid} |
| Headers | Authorization, Content-Type |
| Path Parameters | uuid |
| Query Parameters | Not applicable |
| Body Parameters | op, path, value |
Pour valider en toute sécurité cette requête en production sans modifier aucune connexion, consultez Tests en production (exécution à blanc de l'API).
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
}
}
}
]'
Réglages du chemin
| Parameter | Mandatory | Type | Example | Applicable Values | Description |
|---|---|---|---|---|---|
| uuid | yes | string | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Equinix-assigned connection identifier. |
Paramètres corporels
| Parameter | Mandatory | Type | Example | Applicable Values | Description |
|---|---|---|---|---|---|
| op | yes | string | replace | replace | Update reqest type. |
| path | yes | string | /aSide/accessPoint | /aSide/accessPoint | Parameter path. |
| value | yes | object | - | ||
| type | yes | string | VD | VD | VD - Virtual Device. |
| virtualDevice | yes | object | - | Virtual Device details. | |
| type | yes | string | EDGE | EDGE | EDGE. |
| uuid | yes | string | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | Unique Id of the new Virtual Device. | |
| interface | no | object | Interface details. | ||
| type | no | string | NETWORK | NETWORK. | |
| id | no | integer | 5 | Interface of the Virtual Device. |
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",
}
}