Migrer la connexion vers un port différent
Migrer la connexion vers un autre port côté A.
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.
-
Obtenez les informations de port en utilisant le point de terminaison Get All Ports pour l'ID du port vers lequel vous souhaitez migrer votre connexion.
Mise à jour de la connexion
Pour mettre à jour une connexion et la migrer vers un autre port, envoyez une requête PATCH au point de terminaison /fabric/v4/connections/{id}. Spécifiez l'identifiant du port côté serveur de la connexion et indiquez le port 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/{connection_id}'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '[
{
"op": "replace",
"path": "/aSide/accessPoint/port/uuid",
"value": "c791f8cb-599a-99a0-8ce0-306a5c00a4ee"
}
]'
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/port/uuid | /aSide/accessPoint/port/uuid | Parameter path. |
| value | yes | string | c791f8cb-599a-99a0-8ce0-306a5c00a4ee | - | Parameter value. |
| /aSide/accessPoint/port/uuid | |||||
| value | yes | string | c791f8cb-599a-99a0-8ce0-306a5c00a4ee | - | Eqinix-assigned port identifier. |
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": {
"type": "COLO",
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-599a-99a0-8ce0-306a5c00a4ee",
"type": "XF_PORT",
"uuid": "c791f8cb-599a-99a0-8ce0-306a5c00a4ee"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"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",
}
}