ModifyNetworkInterfaceAttribute - Elastic Compute Service - Centre de documentation Alibaba Cloud

Modifie les attributs d'une interface réseau élastique (ENI), tels que le nombre de files d'attente, les groupes de sécurité associés, la profondeur de file d'attente, le mode de communication et la conservation ou non de l'ENI lors de la libération de l'instance associée.

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

update

*NetworkInterface.

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

*SecurityGroup.

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'ENI. Vous pouvez appeler DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
NetworkInterfaceName	string	Non	Le nom de l'ENI. Le nom doit comporter de 2 à 128 caractères et commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par `http://` ou `https://`. Le nom peut contenir des caractères de la catégorie des lettres dans Unicode, y compris des lettres anglaises, des caractères chinois et des chiffres. Il peut également contenir des deux-points (:), des traits de soulignement (_), des points (.) ou des traits d'union (-).	eniTestName
NetworkInterfaceId	string	Oui	L'identifiant de l'ENI.	eni-bp67acfmxazb4p****
QueueNumber	integer	Non	Le nombre de files d'attente pour l'ENI. Valeurs valides : 1 à 2048.	8
Description	string	Non	La description de l'ENI. La description doit comporter de 2 à 255 caractères et ne peut pas commencer par http:// ou https://. Valeur par défaut : vide.	testDescription
SecurityGroupId	array	Non	Les identifiants des groupes de sécurité. L'ENI secondaire est ajoutée aux groupes de sécurité spécifiés et retirée des groupes de sécurité existants. Les valeurs valides de N dépendent du quota du nombre maximal de groupes de sécurité auxquels une ENI peut appartenir. Pour plus d'informations, consultez Avant de commencer. La modification prend effet rapidement, mais un léger délai peut survenir.
	string	Non	La liste des identifiants des groupes de sécurité.	sg-bp67acfmxazb4p****
DeleteOnRelease	boolean	Non	Indique si l'ENI doit être conservée lors de la libération de l'instance associée. Valeurs valides :	true
RxQueueSize	integer	Non	La profondeur de la file d'attente entrante du contrôleur d'interface réseau (NIC).	8192
TxQueueSize	integer	Non	La profondeur de la file d'attente sortante du contrôleur d'interface réseau (NIC).	8192
NetworkInterfaceTrafficConfig	object	Non	Les paramètres de communication du contrôleur d'interface réseau (NIC).
NetworkInterfaceTrafficMode	string	Non	Le mode de communication de l'interface réseau. Valeurs valides : Standard : utilise le mode de communication TCP. HighPerformance : active l'Elastic RDMA Interface (ERI) et utilise le mode de communication RDMA. Lorsque l'ENI est à l'état attaché, notez les points suivants : Le nombre total d'interfaces réseau RDMA sur une instance ne peut pas dépasser le quota d'interfaces réseau RDMA autorisé par le type d'instance. Vous pouvez interroger le champ EriQuantity en appelant l'opération DescribeInstanceTypes pour obtenir le quota d'interfaces réseau RDMA autorisé par le type d'instance. Remarque Ce paramètre est en préversion sur invitation et n'est pas encore disponible publiquement.	HighPerformance
QueueNumber	integer	Non	Le nombre de files d'attente pour l'ENI. Lorsque l'ENI est à l'état attaché, tenez compte des points suivants : La valeur ne peut pas dépasser le nombre maximal de files d'attente autorisées par ENI pour le type d'instance. Le nombre total de files d'attente sur toutes les ENI de l'instance ne peut pas dépasser le quota total de files d'attente autorisé pour le type d'instance. Vous pouvez appeler l'opération DescribeInstanceTypes pour interroger les champs MaximumQueueNumberPerEni et TotalEniQueueQuantity afin d'obtenir le nombre maximal de files d'attente par ENI et le quota total du type d'instance. Remarque Ce paramètre est en préversion sur invitation et n'est pas encore disponible publiquement.	8
QueuePairNumber	integer	Non	Le nombre de files d'attente sur l'interface réseau RDMA. Lorsque l'ENI est à l'état attaché, tenez compte des points suivants : La valeur ne peut pas dépasser le nombre maximal de files d'attente autorisées par interface réseau RDMA pour le type d'instance. Vous pouvez appeler l'opération DescribeInstanceTypes pour interroger le champ QueuePairNumber afin de connaître le nombre maximal de files d'attente autorisées par interface réseau RDMA pour le type d'instance. Remarque Ce paramètre est en version préliminaire sur invitation et n'est pas disponible publiquement.	8
RxQueueSize	integer	Non	La profondeur de la file d'attente entrante du contrôleur d'interface réseau (NIC).	8192
TxQueueSize	integer	Non	La profondeur de la file d'attente sortante du contrôleur d'interface réseau (NIC).	8192
ConnectionTrackingConfiguration	object	Non	La configuration du suivi de la connectivité réseau.
TcpEstablishedTimeout	integer	Non	Le délai d'expiration pour les connexions TCP établies. Unité : secondes. Valeurs valides : [30, 60, 80, 100, 200, 300, 500, 700, 910].	910
TcpClosedAndTimeWaitTimeout	integer	Non	Le délai d'expiration pour les connexions TCP à l'état TIME_WAIT ou CLOSED. Unité : secondes. Valeurs valides : nombres entiers de 3 à 15.	3
UdpTimeout	integer	Non	Le délai d'expiration pour les flux UDP. Unité : secondes. Valeurs valides : [10, 20, 30, 60, 80, 100].	30
EnhancedNetwork	object	Non	Ce paramètre n'est pas disponible publiquement.
EnableSriov	boolean	Non	Ce paramètre n'est pas disponible publiquement.	true
EnableRss	boolean	Non	Remarque Ce paramètre n'est pas disponible publiquement.	false
VirtualFunctionTotalQueueNumber	integer	Non
VirtualFunctionQuantity	integer	Non
EnableExpress	boolean	Non
SourceDestCheck	boolean	Non	Indique si la vérification source/destination doit être activée. Nous vous recommandons d'activer cette fonctionnalité pour améliorer la sécurité du réseau. Valeurs valides :	false
EnablePrimaryIPv6	boolean	Non

Éléments de réponse

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

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidOperation.NotSupportModifyQueueNumber	%s
400	MissingParameter	%s	Au moins l'un des paramètres spécifiés doit être fourni. Ils ne peuvent pas tous être 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 est invalide.
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 la modification des attributs de l'ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Le détachement de l'ENI principal d'une instance n'est pas autorisé.
400	InvalidParams.EniId	%s	Le paramètre EniId spécifié est invalide.
400	Forbidden.RegionId	%s	Ce service est temporairement indisponible dans la région actuelle.
400	JoinedGroupLimitExceed	%s	Le nombre maximum de groupes de sécurité auxquels la ressource spécifiée peut être associée a été atteint. Pour plus d'informations, consultez le résultat réel renvoyé par l'espace réservé %s dans le message d'erreur.
400	InvalidEniQueueSize.RegionOrUserNotSupported	The specified parameter RxQueueSize or TxQueueSize is not supported in this region, or this account is not in the whitelist of using eni QueueSize.	La région ou l'utilisateur ne prend pas en charge la définition de la profondeur de file d'attente de l'interface réseau.
400	InvalidParameter.EniQueueSize	The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.	Les profondeurs de file d'attente ENI sortantes et entrantes ne sont pas égales ou ne sont pas dans la plage de valeurs autorisée.
400	InvalidParameter.Conflict	%s	L'opération actuelle ne permet pas de spécifier diskId et imageId en même temps. Assurez-vous que soit diskId soit imageId n'est pas vide.
400	InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported	The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.	La région ou l'utilisateur ne prend pas en charge la configuration des paramètres de connexion de l'interface réseau.
400	InvalidParameter.InvalidQueuePairNumber	The specified parameter QueuePairNumber exceeds limit.	Le nombre spécifié de files d'attente d'interface réseau RDMA dépasse la limite.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specify network interface connection tracking configuration exceeds limit.	La configuration de connectivité réseau spécifiée pour le contrôleur d'interface réseau (NIC) dépasse la plage autorisée.
400	InvalidOperation.MaxEniQueuePairNumberExceed	The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.	Le nombre total de files d'attente RDMA pour l'instance ECS associée à l'interface réseau élastique (ENI) dépasse la limite du type d'instance.
400	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.	Le nombre d'ENI compatibles RDMA attachées à l'instance ECS actuelle dépasse la limite du type d'instance cible.
400	InvalidOperation.InstanceTypeNotSupportHighPerformance	The ECS instance type where the ENI is located does not support the RDMA mode.	Le type d'instance ECS de l'instance ECS à laquelle l'interface réseau élastique (ENI) est attachée ne prend pas en charge le mode de communication RDMA.
400	InvalidTrafficMode.ModifyToStandardNotSupported	The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.	Le mode de communication de l'interface réseau spécifiée ne peut pas être changé du mode de communication RDMA au mode de communication TCP.
400	InvalidOperation.EniTrafficModeNotSupportIPv6	The ENI using High Performance traffic mode does not support IPv6.
400	InvalidOperation.EniQueuePairNumberOverflow	The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit.	Le nombre total de paires de files d'attente pour l'interface réseau élastique (ENI) attachée à l'instance dépasse le maximum autorisé par le type d'instance spécifié.
400	InvalidParameter.QueuePairNumberMustEmpty	When the traffic mode is set to Standard, the QueuePairNumber must be empty.	Lorsque Traffic Mode est défini sur Standard, le paramètre QueuePairNumber spécifié doit être vide.
400	InvalidParameter.EniTrafficMode	The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.	Le mode de communication du contrôleur d'interface réseau (NIC) est invalide. Valeurs valides : Standard et HighPerformance.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	Le type d'instance de l'instance spécifiée ne prend pas en charge l'activation de RSS.
400	InvalidParameter.EniEnhancedNetwork	The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty.	Le paramètre d'amélioration réseau spécifié est invalide. Lorsque EnableSriov est défini sur true, VirtualFunctionTotalQueueNumber ne doit pas être vide et VirtualFunctionQuantity doit être compris entre 1 et 256. Lorsque EnableSriov est vide ou défini sur false, VirtualFunctionTotalQueueNumber et VirtualFunctionQuantity doivent être vides.
400	InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity	The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.	Lorsque EnableSriov est défini sur true, la modification de VirtualFunctionTotalQueueNumber et VirtualFunctionQuantity n'est pas prise en charge.
400	InvalidOperation.TrunkAttachmentMustEmpty	The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.	Lorsque vous définissez EnableSriov sur true, le périphérique attaché à l'ENI trunk doit être vide.
400	Throttling	Request was denied due to request throttling, try again later.	La requête est limitée. Utilisez la méthode de pagination basée sur NextToken au lieu de la méthode de pagination basée sur PageNumber pour les requêtes.
400	InvalidOperation.SourceDestCheckUnsupported	Modifying sourceDestCheck attribute for network interface is not allowed in the %s region.	La région actuelle ne prend pas en charge la modification de la propriété SourceDestCheck d'un contrôleur d'interface réseau (NIC).
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	L'ENI spécifiée ne peut pas activer l'IPv6 principale ou possède déjà une adresse IPv6 principale.
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 ultérieurement.
403	InvalidUserType.NotSupported	%s	Le paramètre de type d'utilisateur est invalide.
403	Abs.InvalidAccount.NotFound	%s	Votre compte Alibaba Cloud n'existe pas, ou votre AccessKey a expiré.
403	Forbidden.NotSupportRAM	%s	Les utilisateurs Resource Access Management (RAM) ne sont pas autorisés à exécuter cette opération.
403	Forbidden.SubUser	%s	Votre compte ne dispose pas de l'autorisation pour opérer 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 être exploitées a été dépassé.
403	EniPerInstanceLimitExceeded	%s	Le nombre d'interfaces réseau élastiques (ENI) attachées à l'instance a atteint le maximum. Aucune interface réseau élastique (ENI) supplémentaire ne peut être attachée à l'instance.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Le contrôleur d'interface réseau (NIC) et l'instance ECS ne sont pas dans la même zone car leurs vSwitches sont dans des zones différentes.
403	InvalidOperation.VpcMismatch	%s	Le VPC du contrôleur d'interface réseau (NIC) 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 est invalide. 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.
403	InvalidOperation.EniServiceManaged	%s	L'opération est invalide.
403	InvalidOperation.MultiGroupType	The specified instance can't join different types of security group.	L'instance spécifiée ne peut pas rejoindre des groupes de sécurité de types différents.
403	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise level security group is exceeded.	Le nombre d'interfaces réseau élastiques (ENI) attachées à l'instance ECS actuelle dépasse la limite d'interfaces réseau élastiques (ENI) du type d'instance cible.
403	InvalidParams.NetworkInterfaceName	%s
403	InvalidOperation.ModifyPrimaryEniQueueNumber	Primary NetworkInterface is not allowed to modify queue number.
403	InvalidOperation.InvalidEniState	Available status or ECS instance attached is Stopped is allowed to modify network interface queue number.	L'état actuel de l'ENI ne permet pas la modification des attributs de l'ENI.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Cette opération n'est pas prise en charge car la ressource est gérée par un service cloud. Contactez le service cloud correspondant pour confirmer la raison.
403	InvalidParameter.InvalidEniQueueNumber	%s	Le nombre de files d'attente du contrôleur d'interface réseau (NIC) est incorrect. Consultez le résultat réel renvoyé par l'espace réservé %s dans le message d'erreur pour plus de détails.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Le nombre de files d'attente de l'interface réseau élastique (ENI) dépasse la limite supérieure. Pour plus d'informations, consultez le résultat réel renvoyé par l'espace réservé %s dans le message d'erreur.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Le nombre de files d'attente d'interface réseau élastique (ENI) attachées à l'instance ECS actuelle dépasse la limite de files d'attente du contrôleur d'interface réseau (NIC) du type d'instance cible.
403	AclLimitExceed	%s	Le nombre de règles de groupe de sécurité pour l'ENI ou l'instance dépasse le quota.
403	InvalidOperation.EniTypeUnsupported	The specified eni type does not supported.	Le type d'activité spécifié n'est pas pris en charge.
403	InvalidVSwitch.Ipv6NotEnabled	The VSwitch of ENI does not support IPv6 feature.
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.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	L'ENI principale prend uniquement en charge la modification du nom et de la description de l'ENI.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	Le groupe de sécurité est dupliqué.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	L'opération de ressource demandée est en conflit avec une requête précédente.
409	TokenProcessing	The previous token request is still processing. Please try again later.

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

Notes de version

Consultez Notes de version pour la liste complète.