Todos os produtos
Search

Este produto

    Elastic Compute Service:Manage the primary private IP address

    Central de documentação

    Elastic Compute Service:Manage the primary private IP address

    Última atualização: Oct 30, 2026

    Cada ENI tem um endereço IPv4 privado primário permanente. Não é possível excluí-lo, mas você pode modificá-lo.

    Conceitos principais

    O diagrama a seguir ilustra a relação entre ENIs e endereços IP privados em uma instância ECS. Para usar mais endereços IP, atribua IPs privados secundários à ENI primária ou anexe ENIs secundárias.

    image

    • Elastic Network Interface (ENI): interface de rede virtual anexada a uma instância ECS. Cada instância tem uma ENI primária impossível de desanexar. Você pode anexar várias ENIs secundárias.

    • Endereço IPv4 privado primário: toda ENI tem exatamente um endereço IPv4 privado primário.

      • ENI primária: você pode modificar o endereço IPv4 privado primário.

      • ENI secundária: não é possível modificar o endereço IPv4 privado primário após a criação. Para alterá-lo, desanexe e exclua a ENI; em seguida, crie e anexe uma nova.

    • Endereço IPv4 privado secundário: atribua um ou mais endereços IPv4 privados secundários a uma ENI (geralmente a primária) para implantações com múltiplos IPs. Antes de modificar o endereço IP privado primário, remova a atribuição de todos os endereços IP privados secundários.

    • Endereço IP reservado pelo sistema: o primeiro e os três últimos endereços IPv4 em um bloco CIDR de vSwitch são reservados e não podem ser atribuídos. Por exemplo, em 192.168.1.0/24, os endereços reservados são 192.168.1.0, 192.168.1.253, 192.168.1.254 e 192.168.1.255.

    Especifique um endereço IPv4 privado primário para uma nova instância

    Ao criar uma instância, você pode atribuir um endereço IPv4 privado estático à ENI primária.

    Console

    1. Acesse a página ECS console - Custom Launch.

    2. Na seção Network and Zone, selecione uma VPC e um vSwitch. Alternativamente, clique em Create VPC e Create vSwitch para criar novos recursos. Após a criação, clique no ícone refresh para atualizar e selecione a nova VPC e o novo vSwitch.

    3. Selecione Specify Primary Private IP Address of Primary ENI e insira um endereço IP disponível dentro do bloco CIDR do vSwitch selecionado.

      O sistema verifica a disponibilidade do IP em tempo real. O endereço não deve estar em uso nem reservado.

      Por exemplo, se o bloco CIDR do vSwitch selecionado for 172.27.48.0/20, insira 172.27.48.1 como endereço IP privado primário.

    API

    Chame a operação RunInstances e especifique o parâmetro PrivateIpAddress.

    Modifique o endereço IPv4 privado primário de uma instância existente

    Modificar o endereço IP privado primário exige reiniciar a instância e causa interrupção na rede. Execute esta operação fora dos horários de pico.

    Impactos potenciais

    • Interrupção de service: a instância deve estar no estado Stopped, o que causa interrupção no service.

    • Perda de conectividade de rede da instância:

      • Se o sistema operacional usar um endereço IP estático, alterar o IP privado gera incompatibilidade entre a configuração de rede do SO (como endereço IP e gateway) e as novas definições. Isso pode impedir conexões remotas ou bloquear a comunicação de rede.

      • Aplicações, services cloud (como strings de conexão de banco de dados ou listas de permissões de firewall) ou arquivos de configuração (como /etc/hosts) com o endereço IP original codificado deixarão de funcionar. Atualize-os após a alteração.

    Antes de começar

    1. Pare a instância

      A instância deve estar no estado Stopped e não bloqueada . Se a instância estiver Running, execute stop the instance primeiro.

    2. Conclua as verificações de pré-requisitos

      • Múltiplos endereços IP privados: se a ENI primária tiver endereços IPv4 ou IPv6 privados secundários, execute unassign the secondary private IP addresses ou remove the IPv6 addresses primeiro.

      • (Opcional) Método de obtenção de IP na instância: caso o sistema operacional use um endereço IP estático, altere a configuração de rede para DHCP antes de prosseguir. Com o DHCP, a instância obtém automaticamente seu endereço IP, máscara de sub-rede, gateway padrão e outras configurações.

        Linux

        Consulte How to configure the network as DHCP in a Linux image.

        Windows

        Os passos a seguir usam o Windows Server 2022 como exemplo.

        1. Conecte-se à instância Windows.

          Para obter instruções, consulte Connect to Windows.

        2. Abra o Network and Sharing Center.

        3. Clique em change adapter settings.

        4. Clique duas vezes na interface de rede primária, 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.

    3. (Opcional) Prepare os recursos de rede

      Ignore esta etapa se estiver alterando para um IP disponível dentro do mesmo vSwitch. Nos cenários a seguir, prepare os recursos de rede antecipadamente:

    Altere o endereço IP privado primário

    Console

    1. Acesse a página ECS console - Instances. No canto superior esquerdo, selecione o resource group e a region da instância alvo.

    2. Localize a instância alvo e clique no ID para abrir a página de detalhes.

    3. Clique em All Actions e selecione Network and Security Group.

    4. Altere o endereço IP privado primário:

      1. (Opcional) Para alterar o vSwitch, selecione um vSwitch na mesma zona.

      2. Defina o Private IP Address. O novo endereço deve estar dentro do bloco CIDR do vSwitch de destino.

        Se este campo ficar vazio, o sistema atribuirá automaticamente um novo endereço IP privado primário.

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

      Após alterar o endereço IP privado primário, a instância não inicia automaticamente. Execute Start the instance manualmente.

    API

    Chame a operação ModifyInstanceVpcAttribute para modificar o vSwitch e o endereço IP privado primário.

    Chame a operação DescribeInstances para verificar o novo vSwitch e o endereço IP privado.

    Após alterar o vSwitch, a instância não inicia automaticamente. Chame a operação StartInstance para iniciá-la.

    Configure o endereço IPv4 privado primário de uma ENI secundária

    A possibilidade de especificar o endereço IP privado primário para uma ENI secundária depende do método de criação:

    • Criada com uma instância ECS: o endereço IP é atribuído automaticamente e não pode ser especificado.

    • Criada separadamente: você pode especificar qualquer endereço IP disponível no bloco CIDR do vSwitch. Se não for especificado, o sistema atribui um automaticamente.

    Não é possível modificar o endereço IPv4 privado primário de uma ENI secundária após a criação. Para alterá-lo, desanexe a ENI, execute create a new secondary ENI com o endereço IPv4 privado primário desejado e anexe-a à instância. O novo endereço deve estar disponível dentro do bloco CIDR do vSwitch.