UnassociateEipAddress - Elastic IP Address - Centro de documentación de Alibaba Cloud

Desasocia una dirección IP elástica (EIP) de un recurso en la nube.

Descripción de la operación

La operación UnassociateEipAddress es asíncrona. Después de llamar a esta operación, el sistema devuelve un ID de solicitud, pero la EIP no se desasocia inmediatamente. La tarea de desasociación se ejecuta en segundo plano. Puede llamar a DescribeEipAddresses para consultar el estado de la EIP:
- Si la EIP está en estado Unassociating, significa que se está desasociando. En este estado, solo puede realizar operaciones de consulta.
- Si la EIP está en estado Available, significa que ya se desasoció.
La operación UnassociateEipAddress no admite la desasociación simultánea de la misma EIP.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:UnassociateEipAddress

delete

Instance

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

*Address

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

HaVip

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Force	boolean	No	Especifica si se debe desasociar forzosamente la EIP cuando está asociada a una puerta de enlace NAT que tiene entradas DNAT o SNAT configuradas. Valores válidos: false (predeterminado): no desasocia forzosamente la EIP. true: desasocia forzosamente la EIP.	false
RegionId	string	No	El ID de la región de la EIP que se va a desasociar. Puede llamar a DescribeRegions para consultar el ID de la región.	cn-hangzhou
AllocationId	string	Sí	El ID de la EIP que se va a desasociar.	eip-2zeerraiwb7uj6i0d****
InstanceId	string	No	El ID de la instancia del recurso en la nube del cual se va a desasociar la EIP. Puede ingresar el ID de instancia de una puerta de enlace NAT, una instancia de Classic Load Balancer (CLB), una instancia de ECS, una instancia de controlador de interfaz de red elástica secundaria (NIC), una instancia de dirección IP virtual de alta disponibilidad o una dirección IP.	i-hp3akk9irtd69jad****
InstanceType	string	No	El tipo de recurso en la nube del cual se va a desasociar la EIP. Valores válidos: EcsInstance (predeterminado): una instancia de ECS en una nube privada virtual (VPC). SlbInstance: una instancia de SLB en una nube privada virtual (VPC). NetworkInterface: un controlador de interfaz de red elástica secundaria (NIC) en una nube privada virtual (VPC). Nat: una puerta de enlace NAT. HaVip: una dirección IP virtual de alta disponibilidad. IpAddress: una dirección IP.	EcsInstance
PrivateIpAddress	string	No	La dirección IP privada de la instancia de ECS o de la instancia del controlador de interfaz de red elástica secundaria (NIC) de la cual se va a desasociar la EIP.	192.XX.XX.2
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el RequestId como ClientToken. El RequestId puede ser diferente para cada solicitud de API.	02fb3da4-130e-11****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	You cannot perform the operation when the specified HAVIP is in the Available or InUse state.
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.	Operations are too frequent and tasks conflict with each other.
400	InvalidBindingStatus	The eip binding status invalid.
400	Forbidden.FinancialLocked	The ip business status is invalid.	The error message returned because the instance has overdue payments.
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.	If the ENI is associated with an EIP in cut-through mode, you must disassociate the ENI from the ECS instance.
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	The error message returned because the EIP is locked.
400	InvalidStatus.EcsStatusNotSupport	The special instance status Pending is not support operate	The operation is not supported because the instance is suspended.
400	InvalidStatus.EniStatusNotSupport	%s
400	InvalidStatus.SnatOrDnat	Operation failed because snat or dnat in unstable status.	The EIP failed to be disassociated because the SNAT or DNAT entry is in an unstable state.
400	DependencyViolation.SnatEntry	The specified eip is in ip pool.
400	%s	%s
400	InvalidStatus.NotAllow	Bind instance status invalid	The status of the associated instance is invalid.
400	Forbidden	The eip instance owener error	The EIP does not belong to your account. Check whether you have the permissions to perform the operation on the EIP.
400	InvalidLoadBalancerId.NotFound	LoadBalancerId does not exist.	The ID of the SLB instance does not exist.
400	OperationFailed.SystemBusy	Operation failed because system is busy.	The error message returned because the system is busy. Try again later.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	The specified EIP does not exist. Check whether the specified value is valid.
404	InvalidBindInstance.NotFound	The specified bind instance does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.