CreateVpc - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Lorsque vous appelez cette opération, tenez compte des points suivants :

Vous ne pouvez spécifier qu'un seul bloc CIDR pour chaque VPC.
Une fois le VPC créé, vous ne pouvez pas modifier son bloc CIDR. Toutefois, vous pouvez ajouter des blocs CIDR IPv4 secondaires au VPC.
Dans chaque VPC, les services cloud peuvent utiliser un maximum de 60 000 adresses IP privées. Vous ne pouvez pas augmenter ce quota.
Après la création d'un VPC, un vRouter et une table de routage sont automatiquement créés.
Au plus trois blocs CIDR utilisateur peuvent être ajoutés à un VPC. Si un bloc CIDR utilisateur en inclut un autre, celui dont le masque de sous-réseau est le plus court s'applique. Par exemple, si 10.0.0.0/8 et 10.1.0.0/16 sont tous deux spécifiés, seul 10.0.0.0/8 s'applique.
CreateVpc 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 DescribeVpcAttribute pour interroger l'état de la tâche :
- Si le VPC est dans l'état Creating, il est en cours de création.
- Si le VPC est dans l'état Created, il a été créé.
Vous ne pouvez pas appeler répétitivement l'opération DeleteRouteEntry pour créer des VPC par défaut dans un délai spécifique. En revanche, vous pouvez appeler cette opération de manière répétée pour créer des VPC personnalisés dans un délai donné.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre 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	CreateVpc	L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateVpc.
RegionId	String	Yes	cn-hangzhou	L'ID de la région à laquelle appartient le VPC. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
CidrBlock	String	No	172.16.0.0/12	Le bloc CIDR du VPC. Vous pouvez spécifier l'un des blocs CIDR suivants ou leurs sous-ensembles comme bloc CIDR IPv4 principal du VPC : 192.168.0.0/16, 172.16.0.0/12 et 10.0.0.0/8. Ces blocs CIDR sont des blocs CIDR privés standard tels que définis par les documents Request for Comments (RFC). Le masque de sous-réseau doit avoir une longueur de 8 à 28 bits. Vous pouvez également utiliser un bloc CIDR personnalisé autre que 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16 et leurs sous-réseaux comme bloc CIDR IPv4 principal du VPC.
Ipv6CidrBlock	String	No	2408:XXXX:0:6a::/56	Les blocs CIDR IPv6 du VPC.
VpcName	String	No	abc	Le nom du VPC. Le nom doit comporter entre 1 et 128 caractères et ne peut pas commencer par `http://` ou `https://`.
EnableIpv6	Boolean	No	false	Indique s'il faut activer IPv6. Valeurs valides : false (par défaut) true : oui
Description	String	No	This is my first Vpc	La description du VPC. La description doit comporter entre 1 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
ResourceGroupId	String	No	rg-acfmxazb4ph6aiy****	L'ID du groupe de ressources. Pour plus d'informations sur les groupes de ressources, consultez Qu'est-ce qu'un groupe de ressources ?
Tag.N.Key	String	No	FinanceDept	La clé du tag N à ajouter à la ressource. Vous pouvez spécifier au plus 20 clés de tag. La clé de tag ne peut pas être une chaîne vide. La clé de tag peut comporter au plus 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	FinanceJoshua	La valeur du tag N à ajouter à la ressource. Vous pouvez spécifier au plus 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:`.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement un test à blanc, sans exécuter la requête réelle. Valeurs valides : true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètre manquantes, la syntaxe de requête incorrecte et les limites de service. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée.
UserCidr	String	No	192.168.0.0/12	Le bloc CIDR utilisateur. Séparez les blocs CIDR utilisateur par des virgules (,). Vous pouvez spécifier jusqu'à trois blocs CIDR utilisateur. Pour plus d'informations sur les blocs CIDR utilisateur, consultez la section `Qu'est-ce qu'un bloc CIDR utilisateur ?` dans la FAQ VPC.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	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 parmi 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 varier pour chaque requête.
Ipv6Isp	String	No	BGP	Le type du bloc CIDR IPv6 du VPC. Valeurs valides : BGP (par défaut) : Border Gateway Protocol (BGP) Alibaba Cloud ChinaMobile : China Mobile (FAI unique). ChinaUnicom : China Unicom (FAI unique). ChinaTelecom : China Telecom (FAI unique). Remarque Si votre compte Alibaba Cloud est autorisé à utiliser la bande passante d'un FAI unique, vous pouvez définir ce paramètre sur ChinaTelecom, ChinaUnicom ou ChinaMobile.
Ipv4IpamPoolId	String	No	ipam-pool-sycmt3p2a9v63i****	L'ID du pool IP Address Manager (IPAM) de type IPv4.

Paramètres de réponse

Parameter	Type	Example	Description
VpcId	String	vpc-bp15zckdt37pq72zv****	L'ID du VPC créé.
VRouterId	String	vrt-bp1lhl0taikrteen8****	L'ID du vRouter automatiquement créé par le système après la création du VPC.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	L'ID de la requête.
RouteTableId	String	vtb-bp145q7glnuzdv****	L'ID de la table de routage automatiquement créée par le système après la création du VPC.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	L'ID du groupe de ressources.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/12
&Ipv6CidrBlock=2408:XXXX:0:6a::/56
&VpcName=abc
&EnableIpv6=false
&Description=This is my first Vpc
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&DryRun=false
&UserCidr=192.168.0.0/12
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6Isp=BGP
&Ipv4IpamPoolId=ipam-pool-sycmt3p2a9v63i****
&Common request parameters

Exemples de réponses réussies

XML format

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

<CreateVpcResponse>
    <VpcId>vpc-bp15zckdt37pq72zv****</VpcId>
    <VRouterId>vrt-bp1lhl0taikrteen8****</VRouterId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp145q7glnuzdv****</RouteTableId>
    <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
</CreateVpcResponse>

JSON format

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

{
  "VpcId" : "vpc-bp15zckdt37pq72zv****",
  "VRouterId" : "vrt-bp1lhl0taikrteen8****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteTableId" : "vtb-bp145q7glnuzdv****",
  "ResourceGroupId" : "rg-acfmxazb4ph6aiy****"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidParameter	Specified CIDR block is not valid	Le bloc CIDR spécifié n'est pas valide.
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	InvalidVpcName.Malformed	Specified VPC name is not valid.	Le format du nom du VPC n'est pas valide. Saisissez un nom de VPC valide et réessayez.
400	InvalidVpcDiscription.Malformed	Specified VPC description is not valid.	Le format de la description du VPC n'est pas valide.
400	QuotaExceeded.Vpc	VPC quota exceeded.	Le nombre de VPC dans ce compte a atteint la limite supérieure.
400	ResourceNotAvailable.Vpc	Resource you requested is not available in this region or zone.	La ressource demandée n'est pas disponible dans cette région ou cette zone.
400	InvalidParameter	Specified UserCidr invalid format.	Le format du bloc CIDR utilisateur n'est pas valide.
400	InvalidParameter	Specified UserCidr Subnet mask is not valid .	Le masque de sous-réseau du bloc CIDR utilisateur n'est pas valide.
400	InvalidUserCidr.Quota	Specified UserCidr number is greater than 3.	Le nombre de blocs CIDR utilisateur a atteint la limite supérieure.
400	InvalidUserCidr.Malformed	Specified UserCidr overlapping in of 100.64.0.0/10.	Le bloc CIDR utilisateur que vous spécifiez chevauche 100.64.0.0/10.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	L'ID de groupe de ressources spécifié n'existe pas.
400	OperationUnsupported.ResourceGroupId	ResourceGroup is not supported in this region.	La fonctionnalité de groupe de ressources est désactivée.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	Le FAI IPv6 spécifié n'est pas pris en charge.
400	ResourceNotEnough.Ipv6Cidr	The specified resource of Ipv6Cidr is not enough.	Les adresses IPv6 sont insuffisantes.
400	UnsupportedFeature.IPAM	VPCs cannot be created by using IPAM.	Vous ne pouvez pas utiliser IPAM pour créer un VPC.
403	Forbidden	User not authorized to operate on the specified resource.	Vous n'êtes pas autorisé à effectuer cette opération sur la ressource spécifiée. Vous pouvez demander les autorisations requises et réessayer.
404	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.	RegionId est défini sur une valeur non valide. Vérifiez si le service est disponible dans la région spécifiée.
500	InternalError	The request processing has failed due to some unknown error.	Des erreurs inconnues se sont produites.

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