ModifyVSwitchAttribute - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Modifie la configuration d'un vSwitch spécifié.

Description de l'opération

ModifyVSwitchAttribute est une opération asynchrone. Après avoir appelé cette opération, le système renvoie un identifiant de requête, mais la configuration du vSwitch n'a pas encore été modifiée. La tâche de modification est toujours en cours d'exécution en arrière-plan. Vous pouvez appeler DescribeVSwitchAttributes pour interroger l'état de la modification du vSwitch :
- Si le vSwitch est dans l'état Pending, la configuration est en cours de modification.
- Si le vSwitch est dans l'état Available, le vSwitch est disponible.
ModifyVSwitchAttribute ne prend pas en charge les modifications simultanées du même vSwitch.

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.

vpc:ModifyVSwitchAttribute

update

*VSwitch.

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VSwitchId	string	Oui	L'identifiant du vSwitch.	vsw-25nacdfvue4****
VSwitchName	string	Non	Le nouveau nom du vSwitch. Le nom doit comporter de 1 à 128 caractères et ne peut pas commencer par http:// ou https://.	VSwitch-1
RegionId	string	Non	L'identifiant de la région du vSwitch. Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
Description	string	Non	La nouvelle description du vSwitch. La description doit comporter de 1 à 256 caractères et ne peut pas commencer par http:// ou https://.	Ceci est mon vSwitch
Ipv6CidrBlock	integer	Non	Les 8 derniers bits du bloc CIDR IPv6 du vSwitch. Valeurs valides : 0 à 255. Vous ne pouvez définir ce paramètre que lorsque le protocole IPv6 est activé pour le VPC auquel le vSwitch appartient. Ce paramètre vous permet d'attribuer un bloc CIDR IPv6 au vSwitch. Une fois le bloc CIDR IPv6 attribué, il ne peut pas être remplacé par un autre bloc CIDR. Assurez-vous que le bloc CIDR ne chevauche pas ceux des autres vSwitches du même VPC.	10
Ipv6CidrMask	integer	Non	Le masque de bloc CIDR IPv6 du vSwitch. Vous ne pouvez définir ce paramètre que lorsque le protocole IPv6 est activé pour le VPC auquel le vSwitch appartient. Remarque Seule la valeur 64 est prise en charge.	64
EnableIPv6	boolean	Non	Indique si le protocole IPv6 doit être activé pour le vSwitch. Valeurs valides : true : active IPv6. Le protocole IPv6 doit être activé pour le VPC auquel le vSwitch appartient. Vous devez également spécifier Ipv6CidrBlock pour attribuer un bloc CIDR IPv6 au vSwitch. false (par défaut) : désactive IPv6. Avant de désactiver IPv6 pour le vSwitch, assurez-vous qu'aucune adresse IPv6 n'est utilisée. Vous ne pouvez pas spécifier Ipv6CidrBlock en même temps.	false
VpcIpv6CidrBlock	string	Non	Le bloc CIDR IPv6 du VPC auquel le vSwitch appartient. Si le VPC possède plusieurs blocs CIDR IPv6, vous pouvez spécifier ce paramètre pour indiquer la plage de blocs CIDR IPv6 pour le vSwitch. Si vous ne spécifiez pas ce paramètre, le bloc CIDR IPv6 attribué lors de l'activation d'IPv6 pour le VPC est utilisé.	2408:XXXX:312:3e00::/56

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemples

JSON format

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	Le format du nom du vSwitch n'est pas valide. Vérifiez le format du nom du vSwitch.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	La description du vSwitch n'est pas valide.
400	Forbidden.VRouterNotFound	specified virtual switch is not found during access authentication.	Le commutateur virtuel spécifié n'a pas été trouvé lors de l'authentification d'accès.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox ne prend pas en charge la création d'IPv6.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	Des instances IPv6 existent dans le vSwitch.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.	L'entrée de route du VPC est dans un état incorrect.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.	L'opération spécifiée a échoué car la fonctionnalité IPv6 n'est pas activée.
400	ParamExclusive.DisableIpv6AndIpv6CidrBlock	DisableIpv6 and Ipv6Cidr are mutually exclusive.	Conflit d'opération. Vous ne pouvez pas modifier Ipv6Cidr et désactiver la fonctionnalité IPv6 en même temps.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	L'état actuel du CBN est incorrect.
400	DependencyViolation.IPv6CidrReservation	The specified resource of [%s] depends on [%s], so the operation cannot be completed.	La ressource [%s] dépend d'un bloc CIDR IPv6 réservé. Supprimez la ressource dépendante avant d'effectuer cette opération.
400	IllegalParam.VpcIpv6CidrBlock	The parameter of VpcIPv6CidrBlock is illegal.	Le paramètre VpcIPv6CidrBlock n'est pas valide.
400	OperationFailed.Ipv6AlreadyEnabled	Operation failed because the IPv6 is enabled already.	L'opération a échoué car l'IPv6 est déjà activé.
400	OperationFailed.Ipv6CidrBlockExisted	Operation failed because the specified IPv6 CIDR block is used already.	L'opération a échoué car le bloc CIDR IPv6 spécifié est déjà utilisé.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	Le bloc CIDR IPv6 n'est pas valide.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.	Le format de description de la ressource spécifié n'est pas valide. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.
400	OperationFailed.VpcIpv6Disabled	Operation failed because the VPC has not enabled IPv6.	L'opération actuelle n'est pas prise en charge car l'IPv6 n'est pas activé pour le VPC.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.
400	OperationFailed.Ipv6CidrBlockUsed	Operation failed because the specified IPv6 CIDR block is used already.	L'opération a échoué car le bloc CIDR IPv6 spécifié est déjà utilisé.
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	Les opérations EIP sont trop fréquentes.
400	OperationDenied.HasSecondaryZone	The operation is not allowed because the VSwitch has a secondary zone.	Les opérations IPv6 ne sont pas autorisées lorsque le vSwitch est configuré avec une zone secondaire.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	Le VpcIpv6CidrBlock spécifié n'existe pas dans le VPC.
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	L'opération est refusée car les ressources de bloc CIDR disponibles sont insuffisantes.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	Le masque IPv6 spécifié n'est pas valide. Seul %s est pris en charge.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Au moins l'un des paramètres Ipv6CidrBlock ou Ipv6CidrMask doit être spécifié.
500	SystemBusy	The system is busy. Please try again later.	Le système est occupé. Réessayez plus tard.
404	InvalidVSwitchId.NotFound	The specified virtual switch does not exists.

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

Notes de version

Consultez Notes de version pour la liste complète.