Todos os produtos
Search
Central de documentação

Elastic Container Instance:Configure um IP fixo para uma instância ECI

Última atualização: Jun 28, 2026

Por padrão, o endereço IP de uma instância ECI é liberado quando a instância é excluída. Caso sua aplicação exija um endereço IP persistente, ative o recurso de endereço IP fixo. Esse recurso mantém o endereço IP por um período especificado após a exclusão da instância. Nesse período, reatribua o endereço IP retido a uma nova instância para garantir a continuidade do IP do serviço. Este tópico descreve como configurar uma instância ECI para usar um endereço IP fixo.

Como funciona

Ao criar uma instância ECI, o sistema atribui aleatoriamente um endereço IP do bloco CIDR do vSwitch especificado. Quando a instância é excluída, seu endereço IP também é liberado e qualquer nova instância recebe um endereço IP diferente. Certos cenários de negócios, como serviços expostos diretamente por meio de um endereço IP, exigem um endereço IP persistente para garantir a continuidade das operações.

Para atender a essa necessidade, o ECI oferece o recurso de endereço IP fixo. Ao criar uma instância ECI com esse recurso ativado, o sistema atribui dois endereços IP do bloco CIDR do vSwitch especificado: um endereço IP dinâmico (endereço interno não visível) e um endereço IP fixo. Após a exclusão da instância, o sistema retém seu endereço IP fixo. Durante o período de retenção (48 horas por padrão), se você criar uma nova instância com o mesmo nome, no mesmo vSwitch e com o recurso de endereço IP fixo ativado, o sistema reatribuirá o endereço IP retido à nova instância. Isso garante que o endereço IP do serviço permaneça inalterado.

Parâmetros

Ao chamar a operação de API CreateContainerGroup para criar uma instância ECI, use parâmetros como FixedIp para ativar o recurso de endereço IP fixo. A tabela a seguir descreve os parâmetros relevantes. Para obter mais informações, consulte CreateContainerGroup.

Parâmetro

Tipo

Exemplo

Descrição

VSwitchId

string

vsw-bp1xpiowfm5vo8o3c****

ID do vSwitch ao qual a instância pertence.

Especifique um vSwitch ao ativar o recurso de endereço IP fixo.

SecurityGroupId

string

sg-2ze468xqmne3u4ak*

ID do grupo de segurança ao qual a instância pertence.

Especifique um grupo de segurança ao definir um vSwitch.

FixedIp

string

true

Defina este parâmetro como true para ativar o recurso de endereço IP fixo na instância.

FixedIpRetainHour

integer

24

Período de retenção, em horas, do endereço IP fixo após a exclusão da instância. O valor padrão é 48.

Exemplo

  1. Crie uma instância ECI chamada A com o recurso de endereço IP fixo ativado.

    O exemplo a seguir mostra os parâmetros para chamar a operação de API CreateContainerGroup e criar a instância A:

    RegionId=cn-beijing
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    ContainerGroupName=test
    Container.1.Name=nginx1
    Container.1.Image=registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2
    FixedIp=true
  2. Verifique o endereço IP da instância A.

    Chame a operação de API DescribeContainerGroups com o ID da instância retornado ou visualize o endereço IP no console.

    Na página de lista de instâncias ECI, localize o endereço IP interno da instância A na coluna IP Address, por exemplo, 172.16.11.71.

  3. Exclua a instância A.

  4. Crie uma instância ECI chamada B.

    Chame a operação de API CreateContainerGroup com os seguintes parâmetros para criar a instância B. O nome da instância e o vSwitch são os mesmos da instância A, e o recurso de endereço IP fixo está ativado.

    RegionId=cn-beijing
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    ContainerGroupName=test
    Container.1.Name=nginx2
    Container.1.Image=registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.15.10
    FixedIp=true
  5. Confirme se o endereço IP da instância B é igual ao da instância A.

    Na página de lista de instâncias ECI, confirme se o endereço IP interno da instância B na coluna IP Address corresponde ao da instância A (por exemplo, 172.16.11.71).