CreateVSwitch - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Lors de l'appel à cette opération, tenez compte des limites suivantes :

Vous pouvez créer au maximum 150 vSwitches dans un VPC (Virtual Private Cloud).
La première adresse IP et les trois dernières adresses IP de chaque bloc CIDR de vSwitch sont réservées. Par exemple, si le bloc CIDR d'un vSwitch est 192.168.1.0/24, les adresses IP 192.168.1.0, 192.168.1.253, 192.168.1.254 et 192.168.1.255 sont réservées.
Le nombre d'instances dans un vSwitch ne peut pas dépasser la capacité restante du VPC. La capacité restante correspond à la différence entre 15 000 et le nombre actuel d'instances.
Chaque instance ne peut appartenir qu'à un seul vSwitch.
Les vSwitches ne prennent pas en charge le multicast ni le broadcast.
Une fois le vSwitch créé, vous ne pouvez plus modifier son bloc CIDR.
CreateVSwitch est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un ID de requête et exécute la tâche en arrière-plan. Appelez l'opération DescribeVSwitchAttributes pour interroger l'état de la tâche.
- Si le vSwitch est dans l'état Pending, il est en cours de configuration.
- Si le vSwitch est dans l'état Available, il est disponible.
Vous ne pouvez pas appeler l'opération CreateVSwitch de manière répétée pour créer un vSwitch dans un VPC pendant la période spécifiée.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateVSwitch	Opération à effectuer. Définissez la valeur sur CreateVSwitch.
Tag.N.Key	String	No	FinanceJoshua	Clé du tag N à ajouter à la ressource. Vous pouvez spécifier au maximum 20 clés de tag. La clé de tag ne peut pas être une chaîne vide. La clé de tag peut comporter au maximum 128 caractères. Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.
Tag.N.Value	String	No	FinanceDept	Valeur du tag N à ajouter à la ressource. Vous pouvez spécifier au maximum 20 valeurs de tag. La valeur de tag peut être une chaîne vide. La valeur de tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ou `https://`. La valeur de tag ne peut pas commencer par `aliyun` ou `acs:`.
ZoneId	String	Yes	cn-hangzhou-b	ID de zone du vSwitch. Appelez l'opération DescribeZones pour interroger la liste des zones la plus récente.
RegionId	String	No	cn-hangzhou	ID de région du vSwitch. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
CidrBlock	String	Yes	172.16.0.0/24	Bloc CIDR du vSwitch. Tenez compte des limites suivantes : Le masque de sous-réseau du bloc CIDR doit avoir une longueur de 16 à 29 bits. Le bloc CIDR du vSwitch doit se situer dans le bloc CIDR du VPC auquel appartient le vSwitch. Le bloc CIDR d'un vSwitch ne peut pas être identique au bloc CIDR de destination dans une entrée de route du VPC. Cependant, il peut être un sous-ensemble du bloc CIDR de destination.
Ipv6CidrBlock	Integer	No	12	Huit derniers bits du bloc CIDR IPv6 du vSwitch. Valeurs valides : 0 à 255.
VpcId	String	Yes	vpc-257gqcdfvx6n****	ID du VPC dans lequel vous souhaitez créer le vSwitch.
VSwitchName	String	No	vSwitch-1	Nom du vSwitch. Le nom doit comporter de 1 à 128 caractères et ne peut pas commencer par `http://` ou `https://`.
Description	String	No	vSwitch	Description du vSwitch. La description doit comporter de 1 à 256 caractères et ne peut pas commencer par `http://` ou `https://`.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe63****	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 parmi les différentes requêtes. 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 l'ID de requête comme jeton client. L'ID de requête peut être différent pour chaque requête.
VpcIpv6CidrBlock	String	No	2408:XXXX:0:6a::/56	Bloc CIDR IPv6 du VPC.

Paramètres de réponse

Parameter	Type	Example	Description
VSwitchId	String	vsw-25navfgbue4g****	ID du vSwitch.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	ID de la requête.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateVSwitch
&Tag=[{"Key":"FinanceJoshua","Value":"FinanceDept"}]
&ZoneId=cn-hangzhou-b
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/24
&Ipv6CidrBlock=12
&VpcId=vpc-257gqcdfvx6n****
&VSwitchName=vSwitch-1
&Description=vSwitch
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&VpcIpv6CidrBlock=2408:XXXX:0:6a::/56
&Common request parameters

Exemples de réponses réussies

XML format

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

<CreateVSwitchResponse>
    <VSwitchId>vsw-25navfgbue4g****</VSwitchId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateVSwitchResponse>

JSON format

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

{
  "VSwitchId" : "vsw-25navfgbue4g****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	Le format du nom de vSwitch spécifié n'est pas valide. Spécifiez le nom dans un format valide.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	La description du vSwitch n'est pas valide.
400	MissingParam.vpcId	The parameter vpcId is mandatory.	Le paramètre vpcId est requis.
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.	Vous ne pouvez pas créer de vSwitch dans la région ou la zone actuelle.
400	InvalidParameter	Specified CIDR block is not valid in VPC.	Le bloc CIDR ne fait pas partie du bloc CIDR du VPC.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.	Le bloc CIDR du vSwitch chevauche un autre bloc CIDR de vSwitch ou le bloc CIDR de destination d'une entrée de route personnalisée. Essayez un autre bloc CIDR qui n'est pas utilisé.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other entry.	Le bloc CIDR du vSwitch chevauche un autre bloc CIDR de vSwitch ou le bloc CIDR de destination d'une entrée de route personnalisée. Essayez un autre bloc CIDR qui n'est pas utilisé.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	Le nombre de vSwitches a atteint la limite supérieure. Réduisez le nombre de vSwitches et réessayez ultérieurement.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	Une ou plusieurs entrées de route dans la table de routage actuelle sont dans l'état Pending ou Modifying.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	Plusieurs vSwitches sont dans l'état Modifying dans le même VPC. Réessayez ultérieurement.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	Le format du bloc CIDR n'est pas valide.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	Cette opération ne peut pas être effectuée lorsque le VPC est dans l'état actuel.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Vous ne pouvez pas créer de vSwitch lorsque l'instance CEN est dans l'état actuel.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	Le format du bloc CIDR spécifié n'est pas valide.
400	MissingParameter	Miss mandatory parameter.	Un ou plusieurs paramètres requis ne sont pas définis. Vérifiez si vous avez défini tous les paramètres requis avant d'appeler cette opération.
400	IncorrectVSwitchStatus	VSwitch Creation simultaneously is not supported.	Le système n'a pas pu créer le vSwitch et un ou plusieurs vSwitches appartenant au VPC sont dans l'état Creating.
400	TaskConflict	The operation is too frequent, TaskConflict.	Le système est occupé. Réessayez ultérieurement.
400	Forbidden.VpcNotFound	Specified VPC can not found.	Le VPC spécifié n'existe pas.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Des conflits de routes existent dans la table de routage.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	L'état de l'instance CEN n'est pas valide.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	Vous ne pouvez pas créer d'adresse IPv6 pour une cloud box.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	Le VPC possède une connexion d'appairage VPC.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	L'opération n'est pas autorisée car le VPC est attaché à une instance CEN.
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	L'opération n'est pas autorisée car des passerelles NAT existent dans le VPC.
400	MissingParam.Ipv6CidrBlock	The parameter Ipv6CidrBlock is mandatory.	Le paramètre Ipv6CidrBlock est requis.
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	Le VPC possède une connexion d'appairage VPC.
404	InvalidZoneId.NotFound	Specified zone does not exist.	L'ID de zone n'est pas valide.
404	InvalidVpcId.NotFound	Specified VPC does not exist.	Le VPC est introuvable.

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