UnassociateEipAddress - Elastic IP Address: Central de Documentação do Alibaba Cloud

Desassocia um elastic IP address (EIP) de um recurso em nuvem.

Descrição da operação

A operação UnassociateEipAddress é assíncrona. Após chamar esta operação, o sistema retorna um ID de solicitação, mas o EIP não é desassociado imediatamente. A tarefa de desassociação é executada em segundo plano. Você pode chamar DescribeEipAddresses para consultar o status do EIP:
- Se o EIP estiver no estado Unassociating, o EIP está sendo desassociado. Nesse estado, você só pode realizar operações de consulta.
- Se o EIP estiver no estado Available, o EIP está desassociado.
A operação UnassociateEipAddress não suporta a desassociação simultânea do mesmo EIP.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:UnassociateEipAddress

delete

Instância.

acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}

*Address.

acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}

HaVip.

acs:vpc:{#regionId}:{#accountId}:havip/{#HaVipId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Force	boolean	Não	Especifica se deve desassociar forçadamente o EIP quando o EIP estiver associado a um gateway NAT que tenha entradas DNAT ou SNAT configuradas. Valores válidos: false (padrão): não desassocia forçadamente o EIP. true: desassocia forçadamente o EIP.	false
RegionId	string	Não	O ID da região do EIP a ser desassociado. Você pode chamar DescribeRegions para consultar o ID da região.	cn-hangzhou
AllocationId	string	Sim	O ID do EIP a ser desassociado.	eip-2zeerraiwb7uj6i0d****
InstanceId	string	Não	O ID da instância do recurso em nuvem da qual o EIP deve ser desassociado. Você pode inserir o ID da instância de um gateway NAT, uma instância de Classic Load Balancer (CLB), uma instância ECS, uma instância de controlador de interface de rede elástica secundária (NIC), uma instância de endereço IP virtual de alta disponibilidade ou um endereço IP.	i-hp3akk9irtd69jad****
InstanceType	string	Não	O tipo de recurso em nuvem do qual o EIP deve ser desassociado. Valores válidos: EcsInstance (padrão): uma instância ECS em uma virtual private cloud (VPC). SlbInstance: uma instância SLB em uma virtual private cloud (VPC). NetworkInterface: um controlador de interface de rede elástica secundária (NIC) em uma virtual private cloud (VPC). Nat: um gateway NAT. HaVip: um endereço IP virtual de alta disponibilidade. IpAddress: um endereço IP.	EcsInstance
PrivateIpAddress	string	Não	O endereço IP privado da instância ECS ou da instância de controlador de interface de rede elástica secundária (NIC) da qual o EIP deve ser desassociado.	192.XX.XX.2
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	02fb3da4-130e-11****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectEipStatus	Current elastic IP status does not support this operation.
400	InvalidInstanceId.NotFound	Specified instance does not exist.
400	IncorrectInstanceStatus	The current status of instance does not support this operation.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.
400	IncorrectHaVipStatus	This operation is denied because satus of the specified HaVip is neither Available nor InUse.	Esta operação é permitida apenas quando a instância HaVip estiver no estado Available ou InUse.
400	OperationDenied	Eip of default vpc not allow this operation
400	InvalidParameter	The specified parameter is not valid.
400	TaskConflict	The eip operate too frequent, TaskConflict.	A operação é muito frequente. Aguarde um momento e tente novamente.
400	InvalidBindingStatus	The eip binding status invalid.
400	Forbidden.FinancialLocked	The ip business status is invalid.	Esta operação não pode ser realizada quando a interface do roteador possui um pagamento em atraso.
400	InvalidIpStatus.HasBeenUsedBySnatTable	The removed ip address has been used by snat table.
400	InvalidIpStatus.HasBeenUsedByForwardEntry	The specified address has been used by forwardTable.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	Quando uma ENI está associada a um EIP pass-through, a ENI deve ser desassociada da instância ECS.
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	A instância do EIP está bloqueada.
400	InvalidStatus.EcsStatusNotSupport	The special instance status Pending is not support operate	A instância está no estado Suspended e não suporta esta operação.
400	InvalidStatus.EniStatusNotSupport	%s
400	InvalidStatus.SnatOrDnat	Operation failed because snat or dnat in unstable status.	Falha ao desassociar o EIP porque a entrada SNAT ou DNAT está em um estado instável.
400	DependencyViolation.SnatEntry	The specified eip is in ip pool.
400	%s	%s
400	InvalidStatus.NotAllow	Bind instance status invalid	O status da instância anexada é inválido.
400	Forbidden	The eip instance owener error	O EIP não pertence ao chamador atual. Verifique se você tem permissão para usar este EIP.
400	InvalidLoadBalancerId.NotFound	LoadBalancerId does not exist.	O ID de load balancing especificado não existe.
400	OperationFailed.SystemBusy	Operation failed because system is busy.	O sistema está ocupado. Tente novamente mais tarde.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	O endereço IP público especificado não existe. Verifique se o parâmetro especificado está correto.
404	InvalidBindInstance.NotFound	The specified bind instance does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.