Saltar al contenido principal

Migrar la conexión a un dispositivo virtual diferente

Requisitos previos​

  1. 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.

  2. 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.

  3. 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étodoPARCHE
URL o punto final/fabric/v4/connections/{uuid}
EncabezadosAuthorization, Content-Type
Parámetros de la rutauuid
Parámetros de consultaNo aplicable
Parámetros corporalesop, 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ámetroObligatorioTipoEjemploValores aplicablesDescripción
uuidsícadena3a58dd05-f46d-4b1d-a154-2e85c396ea62-Identificador de conexión asignado por Equinix.

Parámetros del cuerpo

ParámetroObligatorioTipoEjemploValores aplicablesDescripción
opsícadenareemplazarreemplazarActualizar tipo de solicitud.
rutasícadena/Aside/AccessPoint/Aside/AccessPointRuta de los parámetros.
Valorsíobjeto-
escriba asícadenaVDVDVD - Dispositivo virtual.
dispositivo virtualsíobjeto-Detalles del dispositivo virtual.
escriba asícadenaEDGEEDGEEDGE.
uuidsícadena78rtdd05-f46d-4b1d-a154-2e85c396yt56Id. único del nuevo dispositivo virtual.
interfaznoobjetoDetalles de la interfaz.
escriba anocadenaRedRED.
IDnonúmero entero5Interfaz 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",
    }
}
¿Le ha resultado útil esta página?