调用CreateVpc接口创建一个专有网络VPC（Virtual Private Cloud）。
API描述
调用该接口创建VPC时，请注意：
- 一个VPC只能指定一个网段，网段的范围包括10.0.0.0/8、172.16.0.0/12和192.168.0.0/16以及它们的子网，网段的掩码为8~24位，默认为172.16.0.0/12。
- VPC创建后无法修改网段。
- 每个VPC支持云资源使用的私网网络地址数量为60,000个，且无法提升配额。
- 创建VPC后，会自动创建一个路由器和一个路由表。
- 每个VPC支持三个用户侧网段。如果多个用户侧网段之间存在包含关系，掩码较短的网段实际生效。例如10.0.0.0/8和10.1.0.0/16中，10.0.0.0/8实际生效。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateVpc | 要执行的操作，取值：CreateVpc。 |
| RegionId | String | 是 | cn-hangzhou | VPC所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。 |
| CidrBlock | String | 否 | 172.16.0.0/12 | VPC的网段。您可以使用以下网段或其子集作为VPC的网段：
|
| Ipv6CidrBlock | String | 否 | 2408:XXXX:0:6a::/56 | VPC的IPv6网段。 |
| EnableIpv6 | Boolean | 否 | false | 是否开启IPv6网段，取值：
|
| VpcName | String | 否 | abc | VPC的名称。 长度为2～128个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），但不能以 |
| Description | String | 否 | This is my first Vpc | VPC的描述信息。 长度为2～256个字符，必须以字母或中文开头，但不能以 |
| ResourceGroupId | String | 否 | rg-acfmxazb4ph6aiy**** | 资源组ID。 关于资源组的更多信息，请参见什么是资源组。 |
| DryRun | Boolean | 否 | false | 是否只预检此次请求，取值：
|
| UserCidr | String | 否 | 192.16.0.0/12 | 用户网段，如需定义多个网段请使用半角逗号（,）隔开，最多支持3个网段。 用户网段的详细信息，请参见网段常见问题中的什么是用户网段。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。 |
| Ipv6Isp | String | 否 | BGP | VPC的IPv6地址段类型，取值：
说明 如果是开通了单线带宽白名单的用户，该字段可以设置为
ChinaTelecom（中国电信）、
ChinaUnicom（中国联通）和
ChinaMobile（中国移动）。
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| VpcId | String | vpc-bp15zckdt37pq72zv**** | 创建的VPC的ID。 |
| VRouterId | String | vrt-bp1lhl0taikrteen8**** | 创建VPC后，系统自动创建的路由器的ID。 |
| RouteTableId | String | vtb-bp145q7glnuzdv**** | 创建VPC后，系统自动创建的路由表的ID。 |
| RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 | 请求ID。 |
| ResourceGroupId | String | rg-acfmxazb4ph6aiy**** | 资源组ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateVpc &RegionId=cn-hangzhou &<公共请求参数>
正常返回示例
XML格式
<CreateVpcResponse> <VRouterId>vrt-bp1lhl0taikrteen8****</VRouterId> <RouteTableId>vtb-bp145q7glnuzdv****</RouteTableId> <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId> <VpcId>vpc-bp15zckdt37pq72zv****</VpcId> <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId> </CreateVpcResponse>
JSON格式
{
"CreateVpcResponse": {
"VRouterId": "vrt-bp1lhl0taikrteen8****",
"RouteTableId": "vtb-bp145q7glnuzdv****",
"ResourceGroupId": "rg-acfmxazb4ph6aiy****",
"VpcId": "vpc-bp15zckdt37pq72zv****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | InvalidRegionId.NotFound | Specified value of "regionId" is not supported. | 指定的 RegionId 不存在，请您检查此产品在该地域是否可用。 |
| 400 | InvalidParameter | Specified CIDR block is not valid | 该网段不合法。 |
| 400 | ResourceNotAvailable | Resource you requested is not available in this region or zone. | 当前地域或可用区不支持创建交换机。 |
| 400 | InvalidVpcName.Malformed | Specified VPC name is not valid. | 专有网络VPC名称格式不正确，请您修复VPC的格式后再重试。 |
| 400 | InvalidVpcDiscription.Malformed | Specified VPC description is not valid. | 该VPC描述的格式不符合要求。 |
| 403 | Forbbiden | User not authorized to operate on the specified resource. | 您没有权限操作该资源，请您申请操作权限后再试。 |
| 400 | QuotaExceeded.Vpc | VPC quota exceeded. | 用户名下的 VPC 数量达到配额上限，请提交工单申请提高配额。 |
| 400 | ResourceNotAvailable.Vpc | Resource you requested is not available in this region or zone. | 您请求的资源在在该地域或可用区中不可用。 |
| 400 | InvalidParameter | Specified UserCidr invalid format. | 该用户侧网段格式不正确。 |
| 400 | InvalidParameter | Specified UserCidr Subnet mask is not valid . | 该用户侧网段的子网掩码不合法。 |
| 400 | InvalidUserCidr.Quota | Specified UserCidr number is greater than 3. | Usercidr达到配额限制。 |
| 400 | InvalidUserCidr.Malformed | Specified UserCidr overlapping in of 100.64.0.0/10. | 该UserCidr和100.64.0.0/10重叠。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 请求处理由于某些未知错误失败。 |
| 400 | InvalidResourceGroupId | The specified ResourceGroupId does not exist. | 资源组ID不存在。 |
| 400 | OperationUnsupported.ResourceGroupId | ResourceGroup is not supported in this region. | 资源组功能未打开。 |
访问错误中心查看更多错误码。
