UnassociateEipAddress - Elastic IP Address - Centre de documentation Alibaba Cloud

Dissocie une adresse IP élastique (EIP) d'une ressource cloud.

Description de l'opération

L'opération UnassociateEipAddress est asynchrone. Après avoir appelé cette opération, le système renvoie un identifiant de requête, mais l'EIP n'est pas immédiatement dissociée. La tâche de dissociation s'exécute en arrière-plan. Vous pouvez appeler DescribeEipAddresses pour interroger l'état de l'EIP :
- Si l'EIP est dans l'état Unassociating, l'EIP est en cours de dissociation. Dans cet état, vous ne pouvez effectuer que des opérations de requête.
- Si l'EIP est dans l'état Available, l'EIP est dissociée.
L'opération UnassociateEipAddress ne prend pas en charge la dissociation simultanée de la même EIP.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vpc:UnassociateEipAddress

delete

Instance

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

*Address

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

HaVip

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Force	boolean	Non	Indique si l'EIP doit être dissociée de force lorsque celle-ci est associée à une passerelle NAT sur laquelle des entrées DNAT ou SNAT sont configurées. Valeurs valides :\n\n- false (par défaut) : ne dissocie pas l'EIP de force.\n\n- true : dissocie l'EIP de force.	false
RegionId	string	Non	L'identifiant de la région de l'EIP à dissocier.\n Vous pouvez appeler DescribeRegions pour interroger l'identifiant de la région.	cn-hangzhou
AllocationId	string	Oui	L'identifiant de l'EIP à dissocier.	eip-2zeerraiwb7uj6i0d****
InstanceId	string	Non	L'identifiant de l'instance de ressource cloud de laquelle dissocier l'EIP.\nVous pouvez saisir l'identifiant d'instance d'une passerelle NAT, d'une instance Classic Load Balancer (CLB), d'une instance ECS, d'une instance d'interface réseau élastique secondaire, d'une instance d'adresse IP virtuelle haute disponibilité ou d'une adresse IP.	i-hp3akk9irtd69jad****
InstanceType	string	Non	Le type de ressource cloud de laquelle dissocier l'EIP. Valeurs valides : EcsInstance (par défaut) : une instance ECS dans un réseau privé virtuel (VPC). SlbInstance : une instance SLB dans un réseau privé virtuel (VPC). NetworkInterface : une interface réseau élastique secondaire dans un réseau privé virtuel (VPC). Nat : une passerelle NAT. HaVip : une adresse IP virtuelle haute disponibilité. IpAddress : une adresse IP.	EcsInstance
PrivateIpAddress	string	Non	L'adresse IP privée de l'instance ECS ou de l'instance d'interface réseau élastique secondaire de laquelle dissocier l'EIP.	192.XX.XX.2
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête.\n\nVous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII.\n\n> Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId comme ClientToken. Le RequestId peut être différent pour chaque requête API.	02fb3da4-130e-11****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.