Todos os produtos
Search
Central de documentação

Elastic Compute Service:Change the VPC for an ECS instance

Última atualização: Oct 30, 2026

Migre uma instância ECS para outra VPC na mesma região e zona para isolar a rede, redesenhar a arquitetura ou resolver conflitos de IP.

Importante

Alterar a VPC de uma instância ECS causa uma interrupção temporária do service. Execute esta operação fora dos horários de pico. Antes de começar, crie um snapshot para fazer backup dos seus dados.

image

Impactos potenciais

  • Interrupção do service: A operação exige que a instância esteja no estado Stopped, o que interrompe os services.

  • Alteração do endereço IP privado:

    • O endereço IP privado principal muda para um novo endereço do bloco CIDR do vSwitch de destino. Especifique o endereço ou deixe o sistema atribuir um. Aplicações com o IP original codificado (hard-coded), como strings de conexão de banco de dados, listas de permissões de firewall ou outras configurações de service, apresentarão falha. atualize essas configurações após alterar a VPC.

    • O endereço IP público permanece inalterado.

  • Perda de conexão de rede: A instância perde a conectividade de rede privada com todos os recursos da VPC original, como instâncias RDS, SLB e outras instâncias ECS.

  • Configuração de rede do sistema operacional: Se o sistema operacional usar um endereço IP estático, as configurações de rede (endereço IP e gateway) não corresponderão ao novo ambiente após a alteração da VPC. Isso impedirá a comunicação de rede e a conexão remota.

Procedimento

Etapa 1: Preparar

  1. crie um snapshot de backup: crie um snapshot do disco do sistema e dos discos de dados da instância para backup e reversão.

  2. Pare a instância

    A instância deve estar no estado Stopped. O status no console não pode ser Locked . Se a instância estiver em execução, pare-a.

  3. Execute as verificações de pré-requisitos:

    • ENIs secundárias: Desvincule todas as ENIs secundárias da instância.

    • Múltiplos endereços IP: Desatribua os endereços IP privados secundários e exclua os endereços IPv6 da ENI principal.

    • Server Load Balancer (SLB): Remova a instância de qualquer grupo de servidores de backend do SLB.

    • Entradas de rota personalizadas: exclua qualquer rota personalizada que use a instância como o próximo salto.

    • Endereço IP virtual de alta disponibilidade (HaVip): Desassocie a instância de qualquer HaVip.

    • **Global Accelerator (GA)**: Exclua o endpoint que contém a instância de qualquer instância do GA.

    • (Opcional) Método de obtenção de endereço IP: Se o sistema operacional da instância usar uma configuração de IP estático, mude para DHCP antes de alterar a VPC. Assim, o sistema operacional obterá automaticamente o novo endereço IP, a máscara de sub-rede e o gateway.

      Linux

      Consulte configure DHCP para uma imagem Linux.

      Windows

      As etapas a seguir usam o Windows Server 2022 como exemplo:

      1. Conecte-se à instância Windows.

        Para obter instruções, consulte Conectar ao Windows.

      2. Abra o Network and Sharing Center.

      3. clique em change adapter settings.

      4. Clique duas vezes na interface de rede principal, Ethernet. Na caixa de diálogo Ethernet Status, clique em Type.

        Abra Control Panel > Network and Internet > Network Connections.

      5. Na caixa de diálogo Ethernet Properties, clique duas vezes em Internet Protocol Version 4 (TCP/IPv4).

      6. Na caixa de diálogo Internet Protocol Version 4 (TCP/IPv4) Properties, selecione Obtain An IP Address Automatically.

  4. Prepare os recursos de rede de destino:

    • VPC e vSwitch: Certifique-se de que existam uma VPC e um vSwitch na mesma zona da instância.

    • Grupo de segurança: Prepare um grupo de segurança na VPC de destino. Clone um grupo de segurança para copiar as regras existentes.

Etapa 2: Alterar a VPC

Console

  1. acesse o ECS console. selecione o grupo de recursos e a região da instância.

  2. Na página Instances, clique no ID da instância para abrir a página de detalhes. Escolha All Operations > Change VPC.

  3. Altere a VPC:

    1. Preparation: Revise as informações e observações de rede.

    2. VPC: defina a Destination VPC, o Destination vSwitch e o Destination Security Group.

      selecione de um a cinco grupos de segurança de destino. Os grupos selecionados devem ser do mesmo tipo: todos básicos ou todos corporativos.
    3. (Opcional) Configure Primary Private IP: Especifique um endereço IP privado principal dentro do bloco CIDR do vSwitch de destino. Se o campo for deixado em branco, o sistema atribuirá um automaticamente.

  4. Verifique os resultados:

    Na página Instance Details, verifique a nova VPC e o novo vSwitch na seção Configuration Information.

    Após a alteração da VPC, a instância não inicia automaticamente. Inicie a instância manualmente.

API

Chame a ModifyInstanceVpcAttribute para alterar a VPC.

Chame a DescribeInstances para verificar a nova VPC, o novo vSwitch e o grupo de segurança.

A instância não inicia automaticamente após a alteração da VPC. Chame a StartInstance para iniciá-la.

Perguntas frequentes

  • Como altero as VPCs de várias instâncias ECS em lote?

    Consulte Executar operações em lote na página Instances. Altere as VPCs de até 20 instâncias por vez.

  • Como converto um bloco CIDR em um intervalo de endereços IP?

    Consulte Exemplos de conversão de blocos CIDR em intervalos de endereços IP. Use também a interface de linha de comando ipcalc em uma instância no vSwitch de destino para visualize o intervalo de endereços IP de um bloco CIDR.

  • Como me inscrevo para receber notificações de eventos sobre os resultados de uma operação de alteração de VPC?

  • Como resolvo o erro InvalidDependence.GrantAccess?

    Causa: A instância está associada a outro service de cloud com link de autorização reversa.

    Solução: Libere o link de autorização reversa. Exclua a autorização para outros products e tente novamente.

    Se um link privado foi gerado pelo Workbench, libere-o da seguinte forma:

    1. Faça logon no Workbench console. Na página Private Links, verifique se existe um link de autorização reversa. Em caso afirmativo, clique em Release Link.

    2. clique em OK para liberar o link e tente alterar a VPC novamente.

  • Como resolvo o erro InvalidDependence.NextHopOfCustomRouter?

    Causa: A instância é o próximo salto em uma entrada de tabela de rotas personalizada.

    Solução: Exclua a entrada de rota que usa a instância como próximo salto:

    1. Faça logon no Route Table console. selecione a região da VPC original da instância.

    2. Na página Route Tables, encontre a rota que usa a instância como próximo salto. clique em Delete para removê-la e tente alterar a VPC novamente.

  • Como resolvo o erro InvalidDependence.SLB?

    Na etapa 4 verifique os resultados de Alterar a VPC, a mensagem de erro InvalidDependence.SLB é exibida. Ela informa que a operação foi rejeitada porque a instância está vinculada a uma instância ALB (Application Load Balancer) ou CLB (Classic Load Balancer).

    Causa: A instância está em um grupo de servidores do SLB, mesmo que não esteja servindo tráfego ativamente.

    Solução: Remova a instância do grupo de servidores de backend do SLB e tente novamente. Consulte crie e gerencie grupos de servidores.

  • Como resolvo o erro EnterpriseGroupLimited.MutliGroupType?

    Causa: Os grupos de segurança selecionados têm tipos inconsistentes. Todos os grupos selecionados devem ser básicos ou todos corporativos.

    Solução: selecione grupos de segurança do mesmo tipo.

  • Como resolvo o erro Invalidinstance.AttachedEni?

    Causa: A instância possui ENIs secundárias vinculadas.

    Solução: Desvincule todas as ENIs secundárias da instância.

  • Como resolvo o erro PrimaryEniHasSubIp?

    Causa: A ENI principal possui endereços IP privados secundários atribuídos.

    Solução: Desatribua os endereços IP privados secundários da instância.

Referências