Migrar la conexión a un puerto diferente
Migrar la conexión a otro puerto del lado A.
Requisitos previos
-
Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
-
Determine el ID de la conexión existente. Utilice el punto final Buscar Conexiones para recuperar una lista de conexiones y determinar el ID de la conexión que desea migrar a un puerto diferente.
-
Obtenga la información del puerto utilizando el punto final Get All Ports para el ID del puerto al que desea migrar su conexión.
Actualización de la conexión
Para actualizar una conexión y migrarla a un puerto diferente, envíe una solicitud PATCH al punto final /fabric/v4/connections/{id}. Especifique el ID del puerto del lado a de la conexión al que está migrando la conexión en el cuerpo de la solicitud.
| 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 |
Para validar de forma segura esta solicitud en producción sin cambiar ninguna conexión, consulte Pruebas en producción (API Dry Run).
Ejemplo de solicitud 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"
}
]'
Parámetros de ruta
| Parameter | Mandatory | Type | Example | Applicable Values | Description |
|---|---|---|---|---|---|
| uuid | yes | string | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Equinix-assigned connection identifier. |
Parámetros corporales
| 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. |
Respuesta de muestra:
{
"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",
}
}