Migre conexões virtuais para uma nova porta
Os usuários do Equinix Fabric podem migrar suas próprias conexões virtuais baseadas em portas sem precisar abrir um chamado de suporte. Para migrar uma conexão, você precisa da Fabric Connection Managerfunção ouFabric Manager.
Requisitos de conexão e porta
Para se qualificar para a migração de conexão de autoatendimento, a conexão e as portas devem atender aos seguintes requisitos:
-
A ligação deve ser uma ligação EVPL.
-
Tanto a origem quanto o destino da conexão devem ser portas.
-
A nova porta de origem ou destino deve estar na mesma conta de faturamento que a porta existente.
-
A nova porta deve ter a mesma prioridade (primária ou secundária) que a porta existente.
observaçãoEsse requisito será atenuado se a conexão virtual tiver uma incompatibilidade de prioridade (primária/secundária) entre as portas de origem (A-Side) e de destino (Z-Side). Uma porta de outra prioridade é elegível para migração para corrigir a incompatibilidade. Consulte Resiliência e redundância de conexão para obter mais detalhes.
-
A nova porta deve ter a mesma encapsulação que a porta existente (Dot1Q, QinQ).
-
O novo porto deve estar localizado na mesma região metropolitana que o porto existente.
-
A nova porta deve ter a capacidade adequada e disponibilidade de VLAN.
As conexões criadas com tokens de serviço, roteadores Fabric Cloud, provedores de serviços ou redes não podem ser migradas. Se precisar migrar essas conexões, você deverá criar uma nova e excluir a existente.
Pré-requisitos
- Portal
- API
-
Faça login no Portal do Cliente e navegue até o Fabric Dashboard.
-
No menu Conexões, selecione Inventário de Conexões .

-
Clique na conexão que você deseja migrar para abrir os Detalhes da conexão .
-
Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte Autenticação API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.
-
Determine o ID da conexão existente. Use o
/fabric/v4/connections/searchterminal para recuperar uma lista de conexões e determinar o ID da conexão que você deseja migrar para outra porta. -
Obtenha as informações da porta usando o
/fabric/v4/portsterminal para o ID da porta para a qual você deseja migrar sua conexão.
Migrações do Lado A
- Portal
- API
Para migrar o lado A da sua conexão para uma porta diferente:
-
Em Detalhes da Conexão , clique em Origem.
-
Na seção Nome da porta , clique em Migrar.

-
Na seção Migrar esta conexão para uma nova porta, selecione uma porta na lista suspensa. Apenas portas qualificadas estão disponíveis na lista suspensa.
observaçãoSe a porta selecionada não for do mesmo tipo da porta original, você receberá uma mensagem indicando que as cobranças pela conexão serão alteradas. A seção Visão geral de preços indicará as novas cobranças.
-
Na caixa de diálogo Migrar esta conexão para uma nova porta:
- Verifique se verifiquei a capacidade da porta e a disponibilidade do VLAN na nova porta. Do meu lado, realizarei as alterações necessárias
- Marque para concordar com os termos e condições.

-
Clique em Confirmar.
Os detalhes da conexão indicam que a migração foi iniciada.

Para migrar o A-Side da sua conexão para outra porta, envie uma PATCH solicitação para o /fabric/v4/connections/{id} terminal.
No corpo da solicitação, especifique:
- O
opASreplace - O
pathAS/aSide/accessPoint/port/uuid - O
valuecomo o UUID da porta que é o novo A-Side da conexão.
Exemplo de solicitação 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 com segurança essa solicitação na produção sem alterar nenhuma conexão, consulte Testes em produção (API Dry Run).
Quando a migração for bem-sucedida, a mesma conexão não poderá ser migrada novamente dentro de um período de 24 horas. Essa restrição existe devido à forma como a Equinix atualiza a cobrança e o faturamento da conexão; cada migração aciona uma atualização de cobrança, e o sistema requer um intervalo de 24 horas antes de permitir outra migração para a mesma conexão.
Uma exceção à limitação de 24 horas é se a sua conexão for local (por exemplo, Seattle para Seattle) e a migração de porta A-Side ocorrer entre portas que estão em um Pacote de conexão ilimitada. Essas conexões podem ser migradas mais de uma vez dentro de um período de 24 horas porque não há alteração de cobrança na conexão.
Migrações do lado Z
As migrações do lado Z são suportadas para conexões que terminam em uma porta à qual o usuário tem acesso.
Se a conexão que você deseja migrar terminar em um perfil de serviço gerenciado pela sua organização, você pode abrir um chamado de suporte para solicitar a ativação do seu perfil de serviço para migrações do lado Z nessas portas.
- Portal
- API
Para migrar o lado Z da sua conexão para uma porta diferente:
-
Em Detalhes da Conexão , clique em Destino.
-
Na seção Nome da porta , clique em Migrar.

-
Na seção Migrar esta conexão para uma nova porta, selecione uma porta na lista suspensa. Apenas portas qualificadas estão disponíveis na lista suspensa.
observaçãoSelecionar uma porta com um tipo de faturamento diferente para migrações do lado Z não acarreta alterações no faturamento da conexão.
-
Na caixa de diálogo Migrar esta conexão para uma nova porta:
- Verifique se verifiquei a capacidade da porta e a disponibilidade do VLAN na nova porta. Do meu lado, realizarei as alterações necessárias
- Marque para concordar com os termos e condições.

-
Clique em Confirmar.
Os detalhes da conexão indicam que a migração foi iniciada.
Para migrar o Z-Side da sua conexão para outra porta, envie uma PATCH solicitação para o /fabric/v4/connections/{id} terminal.
No corpo da solicitação, especifique:
- O
opASreplace - O
pathAS/zSide/accessPoint/port/uuid - O
valuecomo o UUID da porta que é o novo Z-Side da conexão. Exemplo de solicitação 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>"
}]'
Migrações subsequentes do lado Z podem ser realizadas sem quaisquer limitações.