DetachNetworkInterface - Elastic Compute Service - Centre de documentation Alibaba Cloud

Détache une interface réseau élastique (ENI) d'une instance Elastic Compute Service (ECS).

Description de l'opération

Prenez note des éléments suivants :

Vous ne pouvez pas détacher l'ENI principale d'une instance.
Assurez-vous que l'ENI à détacher est dans l'état Detaching (Unbinding) ou InUse (Bound).
Assurez-vous que l'instance de laquelle vous souhaitez détacher une ENI est dans l'état Running (Running) ou Stopped (Stopped).
L'opération DetachNetworkInterface est une opération asynchrone. Après l'appel de cette opération pour détacher une ENI, vous pouvez vérifier l'état ou les événements de l'ENI pour déterminer si l'ENI est détachée. La figure suivante illustre les transitions entre les états de l'ENI.
- Si l'ENI est dans l'état Detaching, la requête de détachement de l'ENI est envoyée et l'ENI est en cours de détachement de l'instance associée.
- Si l'ENI est dans l'état Available, l'ENI est détachée de l'instance associée.
- Si l'ENI reste bloquée dans l'état Detaching, le détachement de l'ENI de l'instance associée peut échouer pour des raisons spécifiques. Par exemple, le détachement de l'ENI peut échouer car le système d'exploitation de l'instance n'a pas répondu à la requête de détachement de l'ENI. Si ce problème se produit, vous pouvez relancer la requête de détachement de l'ENI. Si le problème persiste, redémarrez l'instance.

Pour obtenir des exemples d'appel de l'opération DetachNetworkInterface, consultez la rubrique Détacher une ENI d'une instance ECS.

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.

ecs:DetachNetworkInterface

update

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

*Instance

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de l'ENI.	cn-hangzhou
NetworkInterfaceId	string	Oui	L'identifiant de l'ENI.	cn-hangzhou
InstanceId	string	Oui	L'identifiant de l'instance.	eni-bp67acfmxazb4p****
TrunkNetworkInstanceId	string	Non	L'identifiant de l'ENI trunk. Remarque Ce paramètre n'est pas disponible.	i-bp67acfmxazb4p****
		Non	L'identifiant de la requête.	eni-f8zapqwj1v1j4ia3****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	%s	A parameter is not specified.
400	UnsupportedParameter	%s	The parameter is not supported.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidInstanceID.Malformed	%s	The specified InstanceId parameter is invalid.
400	InvalidOperation.InvalidRegion	%s	The specified RegionId parameter is invalid.
400	InvalidOperation.InvalidEcsState	%s	The current status of the instance does not support this operation.
400	InvalidOperation.InvalidEniState	%s	The current status of the ENI does not allow modifying ENI attributes.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Detaching the primary ENI from an instance is not allowed.
400	Forbidden.RegionId	%s	The service is unavailable in the current region.
400	InvalidParams.EniId	%s	The specified EniId parameter is invalid.
400	InvalidParameter.EniNotBelongEcs	%s	The specified ENI does not belong to the specified ECS instance. For more information, see the actual return result of the %s placeholder in the error message. You can call DescribeInstances to view the ENI IDs attached to the specified ECS instance.
400	InvalidOperation.EniHotPlugNotSupported	The ENI with high-performance traffic mode cannot be hot-plugged. Please stop the ECS instance to which the ENI is attached, and try again.	An ENI with high-performance communication mode enabled does not support hot unplugging. Stop the ECS instance to which the ENI is mounted and try again.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.	The specified NIC is not associated with a security group.
403	InvalidUserType.NotSupported	%s	Your account does not support this operation.
403	Abs.InvalidAccount.NotFound	%s	Your Alibaba Cloud account does not exist or your AccessKey pair has expired.
403	Forbidden.NotSupportRAM	%s	RAM users are not authorized to perform this operation.
403	Forbidden.SubUser	%s	You are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization.
403	MaxEniCountExceeded	%s	The maximum number of ENIs that can be managed has been reached.
403	EniPerInstanceLimitExceeded	%s	The maximum number of ENIs that can be attached to the specified instance has been reached.
403	InvalidOperation.AvailabilityZoneMismatch	%s	The operation is invalid.
403	InvalidOperation.VpcMismatch	%s	The operation is invalid. Check whether the VPC in the operation corresponds to other parameters.
403	SecurityGroupInstanceLimitExceed	%s	The number of instances in the security group has reached the maximum limit.
403	InvalidSecurityGroupId.NotVpc	%s	The specified SecurityGroupId parameter is invalid and the network type of the security group is not VPC.
403	InvalidOperation.InvalidEniType	%s	The current type of the Elastic Network Interface (ENI) does not support this operation.
403	InvalidOperation.EniServiceManaged	%s	The operation is invalid.
403	InvalidOperation.EniLinked	%s	The operation is invalid because the current ENI of the instance is associated with other ENIs. You must disassociate the ENI from the other ENIs before you can unbind the ENI from the instance.
403	InvalidInstanceId.NotFound	%s	The specified instance does not exist. Check whether the InstanceId parameter is valid.
403	InvalidOperation.HotPlugNotSupport	%s	The operation is not supported while the specified resource is running. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.InvalidTrunkEniStatus	%s	The current status of the specified trunk-mode ENI does not allow this operation. For more information, see the actual return result in the %s placeholder of the error message.
403	InvalidOperation.TrunkingIsNotAllowed	%s	The trunk network card is not operational.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	The specified instance type does not support trunk mode for Elastic Network Interfaces (ENIs).
403	InvalidParameter.EniNotBelongTrunk	%s	The specified ENI is not in trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.EniTypeNotSupportTrunking	%s	The type of the ENI does not support operations related to the trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.HasMemberEniAttached	%s	Other ENIs are attached to the ENI that works in trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidParameter.EniNotBelongEcs	%s
404	InvalidEcsId.NotFound	%s	The specified instance ID does not exist.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	The specified vSwitch does not exist.
404	InvalidSecurityGroupId.NotFound	%s	The specified security group ID does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.