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 API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

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

3. Determine la información de su dispositivo Network Edge. Necesita un dispositivo virtual/dispositivo redundante/clúster Equinix aprovisionado con una licencia registrada. Compruebe sus dispositivos virtuales y clusters 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 usted no especifica ninguna.

Actualización de la conexión

Para actualizar una conexión y migrarla a un dispositivo virtual diferente, envíe una solicitud PATCH al punto final /fabric/v4/connections/{id}. Especifique el ID del lado a de la conexión al dispositivo virtual 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/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

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	/aSide/accessPoint	Parameter path.
value	yes	object		-
type	yes	string	VD	VD	VD - Virtual Device.
virtualDevice	yes	object		-	Virtual Device details.
type	yes	string	EDGE	EDGE	EDGE.
uuid	yes	string	78rtdd05-f46d-4b1d-a154-2e85c396yt56		Unique Id of the new Virtual Device.
interface	no	object			Interface details.
type	no	string	NETWORK		NETWORK.
id	no	integer	5		Interface of the Virtual Device.

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",  
    }  
}