Todos os produtos
Search
Central de documentação

:UnassignPrivateIpAddresses

Última atualização: Jul 03, 2026

Remove endereços IP privados secundários de uma interface de rede elástica (ENI).

Observações de uso

  • A ENI da qual se deseja remover os endereços IP privados secundários deve estar no estado Available(Available) ou Bound(InUse).

  • Se a ENI for primária, a instância do Elastic Compute Service (ECS) à qual ela está anexada deve estar no estado Running(Running) ou Stopped(Stopped).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

UnassignPrivateIpAddresses

Operação a ser executada. Defina o valor como UnassignPrivateIpAddresses.

RegionId

String

Sim

cn-hangzhou

ID da região da ENI. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

NetworkInterfaceId

String

Sim

eni-bp67acfmxazb4ph****

ID da ENI.

PrivateIpAddress.N

String

Não

192.168..

Endereço IP privado secundário N a remover. Valores válidos de N: 1 a 32.

Ipv4Prefix.N

String

Não

192.168../28

Prefixo IPv4 N. Valores válidos de N: 1 a 10.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID da solicitação.

Exemplos

Solicitações de exemplo

https://ecs.aliyuncs.com/?Action=UnassignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4ph****
&PrivateIpAddress.1=192.168.**.**
&RegionId=cn-hangzhou
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UnassignPrivateIpAddressesResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE70008</RequestId>
</UnassignPrivateIpAddressesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE70008"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

UnsupportedParameter

%s

Parâmetro especificado não suportado.

400

InvalidParameter

%s

Valor de parâmetro inválido.

400

InvalidInstanceID.Malformed

%s

Formato de InstanceId inválido.

400

InvalidOperation.InvalidEcsState

%s

Não é possível executar esta operação na instância no estado atual.

400

InvalidOperation.InvalidEniState

%s

Não é possível executar esta operação na ENI no estado atual.

400

InvalidOperation.DetachPrimaryEniNotAllowed

%s

Não é possível desanexar a ENI da instância.

400

MissingParameter

%s

Parâmetro obrigatório não especificado.

400

Forbidden.RegionId

%s

Serviço indisponível na região no momento.

400

InvalidAction

%s

Operação inválida.

400

InvalidParameter.Conflict

%s

Valor de parâmetro inválido. Verifique se há conflitos de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.

403

InvalidUserType.NotSupported

%s

Sua conta não suporta esta operação.

403

Abs.InvalidAccount.NotFound

%s

Conta Alibaba Cloud não encontrada ou par AccessKey expirado.

403

Forbidden.NotSupportRAM

%s

Usuários do Resource Access Management (RAM) não têm permissão para executar esta operação.

403

Forbidden.SubUser

%s

Sem acesso ao recurso. Entre em contato com o proprietário da conta Alibaba Cloud.

403

MaxEniCountExceeded

%s

Número máximo de ENIs gerenciáveis excedido.

403

EniPerInstanceLimitExceeded

%s

Número máximo de ENIs anexáveis à instância excedido.

403

InvalidOperation.AvailabilityZoneMismatch

%s

Operação inválida.

403

InvalidOperation.VpcMismatch

%s

Operação inválida. Verifique se a VPC na operação corresponde aos outros parâmetros.

403

SecurityGroupInstanceLimitExceed

%s

Número máximo de instâncias no grupo de segurança atingido.

403

InvalidSecurityGroupId.NotVpc

%s

ID de grupo de segurança inválido. O tipo de rede do grupo de segurança especificado não é VPC.

403

InvalidOperation.InvalidEniType

%s

Não é possível executar esta operação neste tipo de ENI.

403

InvalidVSwitchId.IpInvalid

%s

Endereço IP privado inválido.

403

InvalidIp.IpUnassigned

%s

Endereço IP especificado não atribuído.

403

Operation.Conflict

%s

Esta operação entra em conflito com outra em andamento. Tente novamente mais tarde.

403

InvalidOperation.EniServiceManaged

%s

Operação inválida.

403

InvalidIp.IpPrefixMaskInvalid

The ip prefixes mask %s is illegal which must be between %s and %s.

Máscara de prefixo IP inválida e fora do intervalo válido.

403

InvalidIp.IpPrefixMaskNotSame

The ip prefixes %s are illegal which mask must be same.

As máscaras de prefixo IP não são iguais.

403

InvalidIp.IpPrefixNotStrict

The ip prefix must be strict cidr format.

Prefixo IP inválido e fora do formato CIDR.

403

InvalidIp.IpPrefixIllegal

The ip prefixes %s is/are illegal.

Prefixo IP inválido e fora do formato CIDR.

403

MissingParameter

These parameters %s cannot be both empty.

Parâmetro obrigatório não especificado. Os parâmetros obrigatórios não podem estar vazios.

404

InvalidEcsId.NotFound

%s

ID da instância não encontrado.

404

InvalidEniId.NotFound

%s

ID da ENI não encontrado.

404

InvalidVSwitchId.NotFound

%s

ID do vSwitch especificado não encontrado.

404

InvalidSecurityGroupId.NotFound

%s

ID do grupo de segurança especificado não encontrado.

404

InvalidInstanceId.NotFound

%s

InstanceId não encontrado.

500

InvalidOperation.RegionNotSupportIpPrefix

The current region does not support ip prefix.

Não é possível atribuir prefixos IP na região.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.