Migrar conexiones virtuales a un nuevo puerto
Los usuarios de Equinix Fabric pueden migrar sus propias conexiones virtuales basadas en puertos sin necesidad de abrir una solicitud de asistencia. Para migrar una conexión, necesita el Fabric Connection Managerrol ORFabric Manager.
Requisitos de conexión y puerto
Para poder optar a la migración de conexión de autoservicio, la conexión y los puertos deben cumplir los siguientes requisitos:
-
La conexión debe ser una conexión EVPL.
-
Tanto el origen como el destino de la conexión deben ser puertos.
-
El nuevo puerto de origen o destino debe estar en la misma cuenta de facturación que el puerto existente.
-
El nuevo puerto debe tener la misma prioridad de puerto (primaria o secundaria) que el puerto existente.
notaEste requisito se ajusta si la conexión virtual tiene un desfase de prioridad (principal/secundaria) entre los puertos de origen (A-Side) y destino (Z-Side). Un puerto de una prioridad diferente puede ser migrado para corregir la discrepancia. Consulte Resiliencia y redundancia de la conexión para obtener más detalles.
-
El nuevo puerto debe tener la misma encapsulación que el puerto existente (Dot1Q, QinQ).
-
El nuevo puerto debe estar en el mismo metro que el puerto existente.
-
El nuevo puerto debe tener la capacidad y la disponibilidad de VLAN adecuadas.
No se pueden migrar las conexiones creadas con tokens de servicio, enrutadores en la nube de Fabric, proveedores de servicios o redes. Si necesita migrar dichas conexiones, debe crear una nueva y eliminar la existente.
Requisitos previos
- Portal
- API
-
Inicie sesión en el portal del cliente y navegue hasta el panel de control de Fabric .
-
En el menú Conexiones, seleccione Inventario de conexiones .

-
Haga clic en la conexión que desea migrar para abrir sus detalles de conexión .
-
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
/fabric/v4/connections/searchpunto final 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
/fabric/v4/portspunto final del ID del puerto al que desea migrar su conexión.
Migraciones del lado A
- Portal
- API
Para migrar el lado A de su conexión a un puerto diferente:
-
En los detalles de la conexión , haga clic en Origen.
-
En la sección Nombre del puerto, haga clic en Migrar.

-
En la sección Migrar esta conexión a un nuevo puerto, seleccione un puerto de la lista desplegable. Solo los puertos elegibles están disponibles en la lista desplegable.
notaSi el puerto que selecciona no es del mismo tipo que el puerto original, recibirá un mensaje que indica que los cargos por la conexión cambiarán. La sección Resumen de precios indicará los nuevos cargos.
-
En el cuadro de diálogo Migrar esta conexión a un nuevo puerto:
- Compruebe que he verificado la capacidad del puerto y la disponibilidad de VLAN en el nuevo puerto. Realizaré los cambios necesarios en mi extremo.
- Compruebe para aceptar los términos y condiciones.

-
Haga clic en Confirmar.
Los detalles de la conexión indican que se ha iniciado la migración.

Para migrar el A-Side de su conexión a un puerto diferente, envíe una PATCH solicitud al /fabric/v4/connections/{id} punto final.
En el cuerpo de la solicitud, especifique:
- El
opASreplace - El
pathAS/aSide/accessPoint/port/uuid - El
valueAS es el UUID del puerto que es el nuevo A-Side de la conexión.
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": "<new_port_uuid>"
}]'
Para validar de forma segura esta solicitud en producción sin cambiar ninguna conexión, consulte Pruebas en producción (API Seco Run).
Una vez que la migración se realiza correctamente, no se puede volver a migrar la misma conexión en un período de 24 horas. Esta restricción existe debido a cómo Equinix actualiza la facturación y facturación de la conexión; cada migración activa una actualización de facturación y el sistema requiere un intervalo de 24 horas para permitir otra migración para la misma conexión.
Una excepción a la limitación de 24 horas es si su conexión es local (por ejemplo, Seattle a Seattle) y la migración del puerto De A-Side se produce entre puertos que están en un paquete de conexión ilimitado. Estas conexiones se pueden migrar más de una vez en un período de 24 horas porque no hay ningún cambio de facturación en la conexión.
Migraciones Z-Side
Las migraciones del lado Z son compatibles con las conexiones que terminan en un puerto al que el usuario tiene acceso.
Si la conexión que desea migrar termina en un perfil de servicio que gestiona su organización, puede elevar un ticket de soporte para solicitar la habilitación de su perfil de servicio para migraciones del lado Z en esos puertos.
- Portal
- API
Para migrar el lado Z de su conexión a un puerto diferente:
-
En los detalles de la conexión , haga clic en Destino.
-
En la sección Nombre del puerto, haga clic en Migrar.

-
En la sección Migrar esta conexión a un nuevo puerto, seleccione un puerto de la lista desplegable. Solo los puertos elegibles están disponibles en la lista desplegable.
notaLa selección de un puerto de un tipo de facturación diferente para las migraciones del lado Z no conlleva cambios en la facturación de la conexión.
-
En el cuadro de diálogo Migrar esta conexión a un nuevo puerto:
- Compruebe que he verificado la capacidad del puerto y la disponibilidad de VLAN en el nuevo puerto. Realizaré los cambios necesarios en mi extremo.
- Compruebe para aceptar los términos y condiciones.

-
Haga clic en Confirmar.
Los detalles de la conexión indican que se ha iniciado la migración.
Para migrar el Z-Side de su conexión a un puerto diferente, envíe una PATCH solicitud al /fabric/v4/connections/{id} punto final.
En el cuerpo de la solicitud, especifique:
- El
opASreplace - El
pathAS/zSide/accessPoint/port/uuid - El
valueAS es el UUID del puerto que es el nuevo Z-Side de la conexión. 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": "/zSide/accessPoint/port/uuid",
"value": "<new_port_uuid>"
}]'
Las migraciones posteriores del lado Z pueden realizarse sin limitaciones.