Migrer la connexion vers un port différent
Migrer la connexion vers un autre port côté A.
Conditions préalables
-
Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
-
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 sur le port à l'aide du 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 port différent, envoyez une requête PATCH au point de terminaison /fabric/v4/connections/{id}. Spécifiez l'ID du port a-side de la connexion au port vers lequel vous migrez la connexion 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 cette demande en toute sécurité en production sans modifier aucune connexion, consultez Testing in Production (API Dry Run).
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"
}
]'
Paramètres 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",
}
}