DeleteNetworkInterface - Elastic Compute Service - Centre de documentation Alibaba Cloud

Supprime de manière asynchrone une interface réseau élastique (ENI).

Description de l'opération

Lorsque vous appelez cette opération, prenez note des éléments suivants :

L'ENI doit être à l'état Available.
Si l'ENI est attachée à une instance ECS, vous devez d'abord la détacher de l'instance (DetachNetworkInterface) avant de pouvoir supprimer l'ENI.
Une fois l'ENI supprimée :
- Toutes les adresses privées (y compris l'adresse IP privée principale et les adresses IP privées secondaires) de l'ENI sont automatiquement libérées.
- L'ENI supprimée est retirée de tous les groupes de sécurité associés.
Il s'agit d'une opération asynchrone. Après avoir appelé l'opération avec succès, vous pouvez vérifier l'état de l'ENI ou écouter les événements d'opération du contrôleur d'interface réseau (NIC) pour déterminer le résultat. La machine à états de l'ENI est illustrée dans la figure suivante :
- L'état Deleting indique que la requête de suppression a été envoyée avec succès et que l'ENI est en cours de suppression.
- Si l'ENI est introuvable, cela signifie qu'elle a été supprimée.
- Si l'ENI reste à l'état Deleting pendant une période prolongée, la suppression a échoué. Dans ce cas, vous pouvez envoyer une nouvelle requête de suppression pour l'ENI.

Pour plus de détails sur le code d'exemple, consultez Supprimer une ENI.

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

delete

*Interface réseau.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
NetworkInterfaceId	string	Oui	L'identifiant de l'ENI.	eni-bp14v2sdd3v8htln****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	F3CD6886-D8D0-4FEE-B93E-1B73239673DE

Exemples

JSON format

{
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidOperation.HasSlaveEniBonded	%s	L'interface réseau possède encore des interfaces réseau esclaves qui lui sont associées.
400	MissingParameter	%s	Au moins l'un des paramètres spécifiés doit être fourni. Ils ne peuvent pas être tous vides.
400	UnsupportedParameter	%s	Le paramètre spécifié n'est pas pris en charge.
400	InvalidParameter	%s	La combinaison de paramètres spécifiée n'est pas valide.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	L'état actuel de l'instance ne prend pas en charge cette opération.
400	InvalidOperation.InvalidEniState	%s	L'état actuel de l'ENI ne permet pas de modifier les attributs de l'ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Le détachement de l'ENI principale d'une instance n'est pas autorisé.
400	Forbidden.RegionId	%s	Ce service est temporairement indisponible dans la région actuelle.
400	InvalidParams.EniId	%s	Le paramètre EniId spécifié n'est pas valide.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur s'est produite lors de l'envoi de la requête. Réessayez plus tard.
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.	L'ENI spécifiée n'a pas de groupe de sécurité associé.
403	InvalidUserType.NotSupported	%s	Le paramètre de type d'utilisateur n'est pas valide.
403	Abs.InvalidAccount.NotFound	%s	Votre compte Alibaba Cloud n'existe pas ou votre clé AccessKey a expiré.
403	Forbidden.NotSupportRAM	%s	Cette opération n'est pas prise en charge pour les utilisateurs de Resource Access Management (RAM).
403	Forbidden.SubUser	%s	Votre compte ne dispose pas des autorisations nécessaires pour effectuer des opérations sur cette ressource. Demandez les autorisations requises auprès du compte Alibaba Cloud.
403	MaxEniCountExceeded	%s	Le nombre maximal d'interfaces réseau élastiques (ENI) pouvant faire l'objet d'opérations a été dépassé.
403	EniPerInstanceLimitExceeded	%s	Le nombre d'interfaces réseau élastiques (ENI) attachées à l'instance a atteint la limite maximale. Aucune interface réseau élastique (ENI) supplémentaire ne peut être attachée à l'instance.
403	InvalidOperation.AvailabilityZoneMismatch	%s	L'interface réseau élastique (ENI) et l'instance ECS ne se trouvent pas dans la même zone en fonction de leurs configurations de vSwitch.
403	InvalidOperation.VpcMismatch	%s	Le VPC de la carte d'interface réseau ne correspond pas au VPC du groupe de sécurité.
403	SecurityGroupInstanceLimitExceed	%s	Le nombre d'instances dans le groupe de sécurité a atteint la limite maximale.
403	InvalidSecurityGroupId.NotVpc	%s	Le paramètre SecurityGroupId n'est pas valide. Le type de réseau du groupe de sécurité n'est pas VPC.
403	InvalidOperation.InvalidEniType	%s	Le type actuel de l'interface réseau élastique (ENI) ne prend pas en charge cette opération. Le type de contrôleur d'interface réseau (NIC) est incompatible.
403	InvalidEniId.NotFound	%s	L'identifiant de l'interface réseau élastique (ENI) spécifiée n'existe pas. Le contrôleur d'interface réseau (NIC) est introuvable.
403	InvalidOperation.EniServiceManaged	%s	L'opération n'est pas valide.
403	InvalidOperation.TrunkingIsNotAllowed	The account is not authorized to use trunk ENI or perform trunking operation.	Les opérations sur les ENI de relais ne sont pas autorisées. Assurez-vous que votre compte dispose de l'autorisation d'effectuer des opérations sur les ENI trunk. Si vous avez des questions, soumettez un ticket.
404	InvalidEcsId.NotFound	%s	L'identifiant d'instance spécifié n'existe pas.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	Le vSwitch spécifié n'existe pas.
404	InvalidSecurityGroupId.NotFound	%s	Le groupe de sécurité spécifié n'existe pas.

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

Notes de version

Consultez Notes de version pour la liste complète.