Migrar la conexión a un dispositivo virtual diferente

Requisitos previos
-
Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales.
-
Determine el ID de conexión existente. Utilice el punto finalBuscar conexiones para recuperar una lista de conexiones y determinar el ID de la conexión que desea migrar a un puerto diferente.
-
Determina la información de tu dispositivo Network Edge. Necesita un dispositivo virtual Equinix aprovisionado/dispositivos redundantes/clúster con licencia registrada. Compruebe sus dispositivos virtuales y clústeres disponibles llamando a Obtener dispositivos virtuales o Obtener dispositivo virtual {uuid}. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Sin embargo, Equinix seleccionará una interfaz si no especifica una.
Actualización de la conexión
Para actualizar una conexión y migrarla a otro dispositivo virtual, envíe una PATCH solicitud al punto final/fabric/v4/Connections/{id}. Especifique el ID de A-Side de la conexión al dispositivo virtual al que va a migrar la conexión en el cuerpo de la solicitud.
| PARCHE /fabric/v4/Connections/{uuid} | |
|---|---|
| Método | PARCHE |
| URL o punto final | /fabric/v4/connections/{uuid} |
| Encabezados | Authorization, Content-Type |
| Parámetros de la ruta | uuid |
| Parámetros de consulta | No aplicable |
| Parámetros corporales | op, ruta, valor |
Para validar de forma segura esta solicitud en producción sin cambiar ninguna conexión, consulte Pruebas en producción (API Seco Run).
Ejemplo de solicitud 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
}
}
}
]'
Parámetros de ruta
| Parámetro | Obligatorio | Tipo | Ejemplo | Valores aplicables | Descripción |
|---|---|---|---|---|---|
| uuid | sí | cadena | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Identificador de conexión asignado por Equinix. |
Parámetros del cuerpo
| Parámetro | Obligatorio | Tipo | Ejemplo | Valores aplicables | Descripción |
|---|---|---|---|---|---|
| op | sí | cadena | reemplazar | reemplazar | Actualizar tipo de solicitud. |
| ruta | sí | cadena | /Aside/AccessPoint | /Aside/AccessPoint | Ruta de los parámetros. |
| Valor | sí | objeto | - | ||
| escriba a | sí | cadena | VD | VD | VD - Dispositivo virtual. |
| dispositivo virtual | sí | objeto | - | Detalles del dispositivo virtual. | |
| escriba a | sí | cadena | EDGE | EDGE | EDGE. |
| uuid | sí | cadena | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | Id. único del nuevo dispositivo virtual. | |
| interfaz | no | objeto | Detalles de la interfaz. | ||
| escriba a | no | cadena | Red | RED. | |
| ID | no | número entero | 5 | Interfaz del dispositivo virtual. |
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”: {
"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",
}
}