Tous les produits
Search
Centre de documentation

Elastic Compute Service:UnassignIpv6Addresses

Dernière mise à jour :Aug 18, 2026

Désassigne une ou plusieurs adresses IPv6 d'une interface réseau élastique (ENI).

Description de l'opération

Description de l'opération

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

  • L'interface réseau élastique (ENI) doit être dans l'état Active ou InUse.

  • Si vous opérez sur une interface réseau principale (NIC), l'instance ECS à laquelle l'interface réseau est attachée doit être dans l'état Running ou Stopped.

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

delete

*NetworkInterface

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de l'interface réseau (NIC). Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.

cn-hangzhou

NetworkInterfaceId

string

Oui

L'identifiant de la région de l'interface réseau (NIC). Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.

cn-hangzhou

Ipv6Address

array

Non

L'identifiant de l'interface réseau (NIC).

eni-bp14v2sdd3v8ht****

string

Non

One or more IPv6 addresses to delete. Valid values of N: 1 to 10.

Remarque
  • You must specify either the Ipv6Address parameter or the Ipv6Prefix parameter. Otherwise, an error is returned.

2001:db8:1234:1a00::***

Ipv6Prefix

array

Non

Une ou plusieurs adresses IPv6 à désassigner. Valeurs valides de N : 1 à 10.

2001:db8:1234:1a00::***

string

Non

Une ou plusieurs adresses IPv6 à désassigner. Valeurs valides de N : 1 à 10.

Remarque
  • Vous devez spécifier soit le paramètre Ipv6Address, soit le paramètre Ipv6Prefix lorsque vous appelez cette opération. Sinon, une erreur est renvoyée.

2001:db8:1234:1a00::***

Non

Un ou plusieurs préfixes IPv6 à désassigner. Valeurs valides de N : 1 à 10.

É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 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 MissingParameter %s A parameter is not specified.
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 InvalidEniId.Malformed The specified parameter "EniId" is not valid.
400 InvalidParameter.Conflict %s The specified parameter is invalid. Check whether parameter conflicts exist. %s is a variable. An error message is dynamically returned based on call conditions.
500 InvalidOperation.RegionNotSupportIpPrefix The current region does not support ip prefix. You cannot assign IP address prefixes in this region.
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 MissingParameter %s
403 Forbedden.NotSupportRAM %s RAM users are not authorized to perform this operation.
403 Forbbiden.SubUser %s You are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization.
403 InvalidOperation.InvalidEniType %s The current type of the Elastic Network Interface (ENI) does not support this operation.
403 InvalidIp.IpUnassigned %s The specified IP address is not assigned.
403 InvalidIp.IpRepeated %s The specified IP address already exists.
403 InvalidIp.Address %s The IP entered is not in the correct format or is not in the optional CIDR range.
403 Forbidden.RegionId %s
403 InvalidOperation.EniServiceManaged %s The operation is invalid.
403 InvalidIp.IpPrefixIllegal The ip prefixes %s is/are illegal. The IP address prefix is invalid and is not in the CIDR format.
403 InvalidIp.IpPrefixMaskInvalid The ip prefixes mask %s is illegal which must be between %s and %s. The IP address prefix mask is invalid and is not within the valid range.
403 InvalidIp.IpPrefixMaskNotSame The ip prefixes %s are illegal which mask must be same. The IP address prefix masks are not the same.
403 InvalidIp.IpPrefixNotStrict The ip prefix must be strict cidr format. The IP address prefix is invalid and is not in the CIDR format.
404 InvalidEniId.NotFound %s

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

Notes de version

Consultez Notes de version pour la liste complète.