Todos os produtos
Search
Central de documentação

Elastic Compute Service:Change the vSwitch of an ECS instance (primary ENI)

Última atualização: Jul 03, 2026

Mova a ENI primária de uma instância para outro vSwitch na mesma VPC e zona para alterar o bloco CIDR.

  • Mover a ENI primária de uma instância para um vSwitch diferente na mesma VPC e zona de disponibilidade

  • Especifique um novo endereço IP privado do bloco CIDR do vSwitch de destino ou obter uma atribuição automática

image

Impactos potenciais

Analise os impactos abaixo antes de prosseguir:

  • Interrupção de serviço: Pare a instância para alterar o vSwitch.

  • Alteração do endereço IP privado: O endereço IP privado primário muda para um pertencente ao bloco CIDR do vSwitch de destino. Após a alteração, atualize todas as dependências do IP original, como strings de conexão de banco de dados, listas de permissões de firewall ou configurações de serviço.

  • Endereço IP público: Permanece inalterado.

  • Perda de conectividade (apenas IP estático): Se a instância utilizar um endereço IP estático, as configurações de rede interna (endereço IP, máscara de sub-rede e gateway padrão) ficarão inválidas após a mudança do vSwitch. Reconfigure o sistema operacional para usar DHCP antes de alterar o vSwitch.

  • Regras de ACL de rede: Caso os vSwitches de origem e destino possuam regras de ACL de rede diferentes, revise-as e atualize-as para garantir a conectividade da aplicação.

  • Configuração de rotas: O novo vSwitch pode ter regras de roteamento distintas. Associe uma tabela de rotas personalizada ao vSwitch de destino e configure as entradas de rota necessárias para verificar a conectividade.

Pré-requisitos

Certifique-se de que as seguintes condições sejam atendidas:

  • A instância está parada e não se encontra no status Bloqueado.

  • (Se a ENI primária possuir endereços IP secundários) Todos os endereços IPv4 privados secundários foram desatribuídos e todos os endereços IPv6 foram excluídos da ENI primária.

  • (Se a instância utilizar um endereço IP estático) O sistema operacional foi reconfigurado para usar DHCP. Consulte as etapas de configuração de DHCP abaixo.

Configure DHCP em uma instância Linux

Consulte Configurar DHCP para uma instância Linux.

Configure DHCP em uma instância Windows

As etapas a seguir utilizam o Windows Server 2022.

  1. Conecte-se à instância ECS Windows.

  2. Abra a Network and Sharing Center.

  3. Clique em Change adapter settings.

  4. Clique duas vezes na ENI primária chamada Ethernet e clique em Properties.

    Ethernet Status dialog

  5. Em Ethernet Properties, clique duas vezes em Internet Protocol Version 4 (TCP/IPv4).

    Ethernet Properties dialog

  6. Selecione Obtain an IP address automatically e clique em OK.

    image

Alterar o vSwitch

Console

  1. Acesse a página Instâncias do console ECS. Selecione a região e o grupo de recursos desejados.

  2. Clique em ID da instância.

  3. Clique em All Actions > Network and Security Group > Change vSwitch.

  4. Selecione um vSwitch de destino.

  5. Defina o endereço IP privado:

    • Especifique um endereço IP: Insira um endereço IP do bloco CIDR do vSwitch de destino no campo Private IP Address. Essa opção minimiza a reconfiguração caso seja possível reutilizar o mesmo IP na nova sub-rede.

    • Atribuição automática: Deixe o campo Private IP Address em branco para atribuir automaticamente um endereço disponível.

  6. Confirme a alteração.

Após a alteração, o novo vSwitch aparece na seção Configuration Information da página Instance Details.

A instância não reinicia automaticamente. Inicie-a manualmente .

API

Chame a operação ModifyInstanceVpcAttribute para alterar o vSwitch da ENI primária.

Verifique a alteração chamando a operação DescribeInstances e verificando o campo VSwitchId na resposta.

Chame a operação StartInstance para iniciar a instância.

Perguntas frequentes

Como converter entre o formato CIDR e faixas de endereços IP?

Consulte Exemplos de conversão de blocos CIDR para faixas de endereços IP. Você também pode executar o comando ipcalc no vSwitch de destino para visualizar a faixa diretamente.

Como reconfigurar endereços IPv4 ou IPv6 privados secundários após alterar o vSwitch?

Atribua endereços IPv4 e IPv6 privados secundários do bloco CIDR do novo vSwitch. Consulte Atribuir um endereço IP privado secundário a uma ENI e Configurar um endereço IPv6.

Próximas etapas

Referências