CreateVSwitchCidrReservation - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Crée un bloc CIDR réservé pour un vSwitch.

Description de l'opération

Lorsque vous appelez cette opération pour créer un bloc CIDR réservé pour un vSwitch, prenez note des éléments suivants :

Le nombre maximum de blocs CIDR IPv4 et IPv6 réservés dans un VPC est de 100 pour chacun.
Un bloc CIDR réservé ne peut pas contenir les adresses IP réservées par le système du vSwitch auquel il appartient.
- Bloc CIDR IPv4 : les trois premières et les trois dernières adresses IP du vSwitch sont des adresses IP réservées par le système.
- Bloc CIDR IPv6 : les neuf premières et les neuf dernières adresses IP du vSwitch sont des adresses IP réservées par le système.
L'opération CreateVSwitchCidrReservation est asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant d'instance, mais le bloc CIDR réservé pour un vSwitch n'a pas encore été créé. Le système continue d'exécuter le nœud en arrière-plan. Vous pouvez appeler ListVSwitchCidrReservations pour interroger l'état de création du bloc CIDR réservé pour un vSwitch :
- Si le bloc CIDR réservé pour un vSwitch est dans l'état Assigning, le bloc CIDR réservé pour un vSwitch est en cours d'allocation.
- Si le bloc CIDR réservé pour un vSwitch est dans l'état Assigned, le bloc CIDR réservé pour un vSwitch a été alloué.

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

create

*VSwitchCidrReservation.

acs:vpc:{#regionId}:{#accountId}:vswitchcidrreservation/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Tag	array<object>	Non	Les balises de la ressource.
	object	Non	Les informations de balise.
Key	string	Non	La clé de balise de la ressource. Vous pouvez spécifier jusqu'à 20 clés de balise. Si vous spécifiez ce paramètre, la valeur ne peut pas être une chaîne vide. Une clé de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	Non	La valeur de balise de la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. Si vous spécifiez ce paramètre, la valeur peut être une chaîne vide. Une valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir `http://` ou `https://`.	FinanceJoshua
VSwitchId	string	Oui	L'identifiant du vSwitch auquel appartient le bloc CIDR réservé pour un vSwitch.	vsw-25navfgbue4g****
VSwitchCidrReservationName	string	Non	Le nom du bloc CIDR réservé pour un vSwitch. Le nom doit comporter de 1 à 128 caractères et doit commencer par une lettre ou un caractère chinois. Il peut contenir des chiffres, des traits de soulignement (_) et des traits d'union (-). Il ne peut pas commencer par `http://` ou `https://`.	ReservationName
VSwitchCidrReservationDescription	string	Non	La description du bloc CIDR réservé pour un vSwitch. Si vous ne spécifiez pas ce paramètre, la description est vide. La valeur par défaut est vide. La description doit comporter de 1 à 256 caractères et doit commencer par une lettre ou un caractère chinois. Elle ne peut pas commencer par `http://` ou `https://`.	ReservationDescription
IpVersion	string	Non	La version IP du bloc CIDR réservé pour un vSwitch. Valeurs valides : IPv4 (par défaut) IPv6 Remarque Vous n'avez pas besoin de spécifier ce paramètre lorsque vous créez un bloc CIDR réservé IPv4 pour un vSwitch. Ce paramètre est requis lorsque vous créez un bloc CIDR réservé IPv6 pour un vSwitch.	IPv4
VSwitchCidrReservationMask	string	Non	Le masque du bloc CIDR réservé pour un vSwitch. Si IpVersion est défini sur IPv4, la longueur du masque du bloc CIDR réservé doit être supérieure d'au moins 2 bits à celle du masque de bloc CIDR IPv4 du vSwitch et ne peut pas dépasser 28. Si IpVersion est défini sur IPv6, la longueur du masque du bloc CIDR réservé doit être supérieure à celle du masque de bloc CIDR IPv6 du vSwitch et ne peut pas dépasser 80. Remarque Vous devez spécifier soit le paramètre VSwitchCidrReservationMask, soit le paramètre VSwitchCidrReservationCidr. Le bloc CIDR réservé ne peut pas contenir les adresses IP réservées par le système du vSwitch auquel il appartient.	28
VSwitchCidrReservationCidr	string	Non	Le bloc CIDR réservé pour un vSwitch. Si IpVersion est défini sur IPv4, le bloc CIDR réservé pour un vSwitch doit être un sous-ensemble propre du bloc CIDR IPv4 du vSwitch et la longueur du masque ne peut pas dépasser 28. Si IpVersion est défini sur IPv6, le bloc CIDR réservé pour un vSwitch doit être un sous-ensemble propre du bloc CIDR IPv6 du vSwitch et la longueur du masque ne peut pas dépasser 80. Remarque Vous devez spécifier soit le paramètre VSwitchCidrReservationMask, soit le paramètre VSwitchCidrReservationCidr. Le bloc CIDR réservé ne peut pas contenir les adresses IP réservées par le système du vSwitch auquel il appartient.	192.168.1.64/28
VSwitchCidrReservationType	string	Non	Le type du bloc CIDR réservé pour un vSwitch. Valeurs valides : prefix, ce qui indique que les adresses IP sont allouées par bloc CIDR. Remarque Lorsque les utilisateurs ou les services cloud attribuent automatiquement des blocs CIDR aux interfaces réseau élastiques (ENI), les blocs CIDR doivent être alloués à partir du bloc CIDR réservé pour un vSwitch. Si les adresses IP du bloc CIDR réservé pour un vSwitch sont épuisées, le système renvoie une erreur.	prefix
IpPrefixNumber	integer	Non	Le nombre prévu de préfixes IP à réserver. Valeurs valides : 1 à 32.	1
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	Non	Indique si un test à blanc uniquement doit être effectué, sans exécuter la requête réelle. Valeurs valides : true : envoie une requête de vérification sans créer le bloc CIDR réservé pour un vSwitch. Le système vérifie si les paramètres requis sont spécifiés, si le format de la requête est valide et si les limites de service ne sont pas dépassées. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : envoie une requête normale. Une fois la vérification réussie, un code d'état HTTP 2xx est renvoyé et le bloc CIDR réservé pour le vSwitch est créé.	false
RegionId	string	Oui	L'identifiant de la région du vSwitch. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou

Éléments de réponse

Élément	Type	Description	Exemple
	object	L'identifiant d'instance du bloc CIDR réservé pour un vSwitch.
VSwitchCidrReservationId	string	L'identifiant d'instance du bloc CIDR réservé pour un vSwitch.	vcr-bp1m12saqteraw3rp****
RequestId	string	L'identifiant de la requête.	54B48E3D-DF70-471B-AA93-08E683A1B45

Exemples

JSON format

{
  "VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IllegalParamFormat	IllegalParamFormat	Le paramètre spécifié n'est pas valide.
400	IllegalParamFormat.VSwitchCidrReservationCidr	The param format of VSwitchCidrReservationCidr is illegal.	Le format du paramètre VSwitchCidrReservationCidr n'est pas valide.
400	ResourceNotFound.VSwitch	The specified resource of VSwitch is not found.	Le vSwitch associé au contrôleur d'interface réseau (NIC) n'existe pas.
400	UnsupportedFeature.ReservedType	The specified ReservedType is not supported.	Le paramètre ReservedType spécifié n'est pas pris en charge. Saisissez une valeur valide en fonction des spécifications des paramètres de requête.
400	UnsupportedFeature.VSwitchIpv6	The ipv6 feature of switch is not supported.	IPv6 n'est pas activé sur le vSwitch spécifié.
400	OperationFailed.VSwitchCidrReservationCidr	The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr.	Le VSwitchCidrReservationCidr spécifié est en conflit avec un bloc CIDR VSwitchCidrReservation existant.
400	MissingParam.CidrReservationMaskOrCidrReservationCidr	Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified.	VSwitchCidrReservationMask et VSwitchCidrReservationCidr ne peuvent pas être vides simultanément. Spécifiez l'un d'eux et réessayez.
400	UnsupportedRegion	UnsupportedRegion	La région actuelle ne prend pas en charge cette fonctionnalité.
400	UnsupportedFeature.VpcAdvancedFeature	UnsupportedFeature.VpcAdvancedFeature	Le VPC ne prend pas en charge certaines fonctionnalités avancées. Soumettez un ticket pour obtenir de l'aide.
400	QuotaExceeded.CidrReservationCount	The quota of VSwitchCidrReservation is exceeded.	Le nombre de CidrReservations que vous avez créés a dépassé la limite.
400	Conflict.CidrReservationMaskAndCidrReservationCidr	The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict.	Le paramètre VSwitchCidrReservationMask spécifié est en conflit avec VSwitchCidrReservationCidr. Modifiez les paramètres en fonction de la description des métriques dans la documentation de l'API, puis réessayez.
400	OperationFailed.CidrNotEnoughInVSwitch	No enough cidr to allocate in this vswitch.	Le vSwitch spécifié ne dispose pas de suffisamment de blocs CIDR pour allouer une CidrReservation.
400	OperationFailed.SystemReservedIpContained	The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses.	Le VSwitchCidrReservationCidr spécifié ne peut pas contenir d'adresses IP réservées par le système.
400	OperationFailed.AlreadyUsedIpContained	The specified VSwitchCidrReservationCidr cannot contain already used IP addresses.	Le bloc CIDR réservé spécifié ne peut pas contenir d'adresses IP déjà utilisées.
400	IncorrectStatus.VSWITCH	The status of the specified VSwitch is invalid.	L'état du commutateur virtuel est anormal.
400	IllegalParam.VSwitchCidrReservationMask	The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask.	Le VSwitchCidrReservationMask spécifié doit être supérieur d'au moins 2 au masque du vSwitch.
400	QuotaExceeded.VSwitchCidrReservationMask	The operation is failed because of %s. The mask of the reserved subnet cidr exceeds the current default mask of IP Prefix, %s/%s.	L'opération a échoué en raison de la limite de quota %s. Le masque du bloc CIDR réservé dépasse le masque par défaut du préfixe IP actuel, %s/%s.
400	IllegalParam.ReservedType	IpPrefixNumber is only supported with Prefix reserved type.	IpPrefixNumber n'est pris en charge que pour le type de réservation de préfixe.
400	MissingParam.VSwitchCidrReservationParam	One of IpPrefixNumber, VSwitchCidrReservationMask, or VSwitchCidrReservationCidr must be specified.	Vous devez spécifier IpPrefixNumber, VSwitchCidrReservationMask ou VSwitchCidrReservationCidr.
400	Conflict.VSwitchCidrReservationParam	IpPrefixNumber cannot be used together with VSwitchCidrReservationCidr or VSwitchCidrReservationMask.	IpPrefixNumber ne peut pas être utilisé conjointement avec VSwitchCidrReservationCidr ou VSwitchCidrReservationMask.

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

Notes de version

Consultez Notes de version pour la liste complète.