ModifyNetworkInterfaceAttribute - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyNetworkInterfaceAttribute	Opération à effectuer. Définissez la valeur sur ModifyNetworkInterfaceAttribute.
RegionId	String	Yes	cn-hangzhou	ID de région de l'ENI. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
NetworkInterfaceName	String	No	eniTestName	Nom de l'ENI. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des lettres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Ce paramètre est vide par défaut.
NetworkInterfaceId	String	Yes	eni-bp67acfmxazb4p****	ID de l'ENI.
QueueNumber	Integer	No	8	Nombre de files d'attente prises en charge par l'ENI. Valeurs valides : 1 à 2048. Vous pouvez uniquement modifier le nombre de files d'attente des ENI secondaires. La modification du nombre de files d'attente d'une ENI secondaire n'est possible que si l'ENI est dans l'état `Available` ou attachée (`InUse`) à une instance arrêtée (`Stopped`). Le nombre de files d'attente de l'ENI secondaire ne doit pas dépasser le nombre maximal autorisé par type d'instance pour chaque ENI. Le nombre total de files d'attente sur toutes les ENI de l'instance ne doit pas dépasser le quota pris en charge par le type d'instance. Pour connaître le nombre maximal de files d'attente par ENI et le quota pour un type d'instance, appelez l'opération DescribeInstanceTypes et vérifiez les valeurs `MaximumQueueNumberPerEni` et `TotalEniQueueQuantity` dans la réponse.
Description	String	No	testDescription	Description de l'ENI. Elle doit comporter entre 2 et 255 caractères et ne peut pas commencer par http:// ou https://. Ce paramètre est vide par défaut.
SecurityGroupId.N	String	No	sg-bp67acfmxazb4p****	ID du groupe de sécurité N auquel ajouter l'ENI. Les valeurs valides de N dépendent du nombre maximal de groupes de sécurité auxquels une ENI peut être ajoutée. Pour plus d'informations, consultez la page Limits. Vous pouvez uniquement modifier les groupes de sécurité associés à une ENI secondaire. Après spécification de ce paramètre, l'ENI secondaire est ajoutée aux groupes de sécurité indiqués et retirée des groupes d'origine. Les nouveaux groupes de sécurité prennent effet après un court délai.
DeleteOnRelease	Boolean	No	true	Indique si l'ENI doit être conservée lors de la libération de l'instance associée. Valeurs valides : true false

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID de la requête.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyNetworkInterfaceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNetworkInterfaceAttributeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Un paramètre requis n'est pas spécifié.
400	UnsupportedParameter	%s	Un paramètre spécifié n'est pas pris en charge.
400	InvalidParameter	%s	Valeur de paramètre non valide.
400	InvalidInstanceID.Malformed	%s	Format InstanceId non valide.
400	InvalidOperation.InvalidEcsState	%s	Cette opération ne peut pas être effectuée sur l'instance dans l'état actuel.
400	InvalidOperation.InvalidEniState	%s	Cette opération ne peut pas être effectuée sur l'ENI dans l'état actuel.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	L'ENI ne peut pas être détachée de l'instance.
400	InvalidParams.EniId	%s	ID d'ENI non valide.
400	Forbidden.RegionId	%s	Le service est indisponible dans la région pour le moment.
400	JoinedGroupLimitExceed	%s	Le nombre maximal de groupes de sécurité auxquels la ressource spécifiée peut être ajoutée est dépassé. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur.
403	InvalidUserType.NotSupported	%s	Le compte ne prend pas en charge cette opération.
403	Abs.InvalidAccount.NotFound	%s	Votre compte Alibaba Cloud est introuvable ou votre paire AccessKey a expiré.
403	Forbidden.NotSupportRAM	%s	Les utilisateurs Resource Access Management (RAM) n'ont pas les autorisations nécessaires pour effectuer cette opération.
403	Forbidden.SubUser	%s	Vous n'avez pas accès à la ressource. Contactez le propriétaire du compte Alibaba Cloud.
403	MaxEniCountExceeded	%s	Le nombre maximal d'ENI pouvant être gérées est dépassé.
403	EniPerInstanceLimitExceeded	%s	Le nombre maximal d'ENI pouvant être attachées à l'instance est dépassé.
403	InvalidOperation.AvailabilityZoneMismatch	%s	L'opération n'est pas valide.
403	InvalidOperation.VpcMismatch	%s	L'opération n'est pas valide. Vérifiez si le virtual private cloud (VPC) de l'opération correspond aux autres paramètres.
403	SecurityGroupInstanceLimitExceed	%s	Le nombre maximal d'instances dans le groupe de sécurité est atteint.
403	InvalidSecurityGroupId.NotVpc	%s	ID de groupe de sécurité non valide. Le type de réseau du groupe de sécurité spécifié n'est pas VPC.
403	InvalidOperation.InvalidEniType	%s	Cette opération ne peut pas être effectuée sur ce type d'ENI.
403	InvalidOperation.EniServiceManaged	%s	L'opération n'est pas valide.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Les groupes de sécurité gérés par les services cloud ne peuvent pas être modifiés.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valeur QueueNumber non valide. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Le nombre maximal de files d'attente sur l'ENI est dépassé. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Le nombre maximal de files d'attente sur toutes les ENI d'une instance est dépassé. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur.
403	AclLimitExceed	%s	Le nombre maximal de règles de groupe de sécurité pouvant être appliquées à l'ENI ou à l'instance est dépassé.
404	InvalidEcsId.NotFound	%s	L'ID d'instance est introuvable.
404	InvalidEniId.NotFound	%s	L'ID d'ENI est introuvable.
404	InvalidVSwitchId.NotFound	%s	L'ID vSwitch est introuvable.
404	InvalidSecurityGroupId.NotFound	%s	L'ID de groupe de sécurité est introuvable.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	Seuls le nom et la description des ENI principales peuvent être modifiés.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.