UnassociateHaVip - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Desassocia um endereço IP virtual de alta disponibilidade (HaVip) de uma instância do Elastic Compute Service (ECS) em uma virtual private cloud (VPC) ou de uma interface de rede elástica (ENI).

Descrição da operação

Ao chamar esta API para desassociar um HaVip de uma instância ECS de VPC ou de uma ENI, observe o seguinte:

O status da instância ECS a ser desassociada deve ser Running ou Stopped.
O status do HaVip a ser desassociado deve ser Available ou InUse.
A API UnassociateHaVip é assíncrona, o que significa que o sistema retorna um ID de solicitação, mas o HaVip ainda não foi desassociado com sucesso e a tarefa de desassociação continua em execução em segundo plano. Você pode chamar a API DescribeHaVips para consultar o status de desassociação do HaVip:
- Quando o HaVip estiver no status Unassociating, indica que a desassociação do HaVip está em andamento.
- Quando o HaVip estiver no status Inuse ou Available, indica que o HaVip foi desassociado com sucesso.
A API UnassociateHaVip não suporta a desassociação simultânea do mesmo HaVip.

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:UnassociateHaVip

delete

*Instance

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

*HaVip

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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 e não pode exceder 64 caracteres de comprimento.	0c593ea1-3bea-11e9-b96b-88e9fe63****
RegionId	string	Sim	O ID da região do HAVIP. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-shanghai
HaVipId	string	Sim	O ID do HAVIP que você deseja desassociar.	havip-2zeo05qre24nhrqpy****
InstanceId	string	Sim	O ID da instância ECS ou da ENI da qual você deseja desassociar o HAVIP.	i-faf344422ffsfad****
Force	string	Não	Especifica se deve forçar a desassociação do HAVIP da instância ECS ou da ENI. Valores válidos: True False (padrão) Nota Se você definir o valor como False, não poderá desassociar o HAVIP da instância primária.	True
InstanceType	string	Não	O tipo da instância da qual você deseja desassociar o HAVIP. Valores válidos: EcsInstance: uma instância ECS NetworkInterface: uma ENI Nota Se você deseja desassociar o HAVIP de uma ENI, este parâmetro é obrigatório.	EcsInstance

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	C44F62BE-9CE7-4277-B117-69243F3988BF

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectHaVipStatus	HaVip can be operated by this action only when it's status is InUse.
400	IncorrectInstanceStatus	ECS instance can be operated by this action only when it's status is Running or Stopped.
400	ResourceNotAssociated	The HaVip and ECS instance are not associated.
400	Forbidden.UnassociateMaster	Unassociating a master instance is not allowed unless the parameter Force is True.
400	HA.VIP.NOT.ASSOCIATED.WITH.INSTANCE	ha vip not associated with instance.
400	OperationFailed.DistibuteLock	Distibute lock fail.	The operation is locked by another request;
400	OperationFailed.QueryNetworkInterfaceInfo	Failed to query network interface information.	The system failed to query ENI information.
400	IllegalParam.InstanceType	The specified instance type is invalid. Only ECS instances and network interface are allowed.	The type of the associated instance does not support this operation.
400	InvalidNetworkInterfaceId.NotFound	The network interface is not found.	The ENI does not exist.
400	ResourceNotFound.Instance	The specified binding resource is not found.
400	Forbidden.HaVip	No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance.	The error message returned because you do not have the permissions to manage the HAVIP. Go to the Quota Center page to acquire the permissions.
400	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidHaVipId.NotFound	The specified HaVip does not exist in the specified region.	The specified HAVIP does not exist in the specified region. Check whether the specified region is correct.
404	InvalidInstanceId.NotFound	The specified Instance does not exist in the specified region.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.