调用CreateVpc接口创建一个专有网络VPC(Virtual Private Cloud)。
使用说明
调用该接口创建VPC时,请注意:
- 一个VPC只能指定一个网段。
- VPC创建后无法修改网段,但可以添加附加IPv4网段。
- 每个VPC支持云资源使用的私网网络地址数量为60,000个,且无法提升配额。
- 创建VPC后,会自动创建一个路由器和一个路由表。
- 每个VPC支持三个用户侧网段。如果多个用户侧网段之间存在包含关系,掩码较短的网段实际生效。例如10.0.0.0/8和10.1.0.0/16中,10.0.0.0/8实际生效。
- CreateVpc接口属于异步接口,即系统会返回一个实例ID,但该VPC尚未创建完成,系统后台的创建任务仍在进行。您可以调用DescribeVpcAttribute查询VPC的创建状态:
- 当VPC处于Creating状态时,表示VPC正在创建中。
- 当VPC处于Created状态时,表示VPC创建完成。
- CreateVpc接口不支持在同一地域内并发创建默认VPC,但支持在同一地域内并发创建非默认VPC。
调试
您可以在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的网段。
|
Ipv6CidrBlock | String | 否 | 2408:XXXX:0:6a::/56 | VPC的IPv6网段。 |
EnableIpv6 | Boolean | 否 | false | 是否开启IPv6网段。取值:
|
VpcName | String | 否 | abc | VPC的名称。 长度为1~128个字符,不能以 |
Description | String | 否 | This is my first Vpc | VPC的描述信息。 长度为1~256个字符,不能以 |
ResourceGroupId | String | 否 | rg-acfmxazb4ph6aiy**** | 资源组ID。 关于资源组的更多信息,请参见什么是资源组。 |
DryRun | Boolean | 否 | false | 是否只预检此次请求。取值:
|
UserCidr | String | 否 | 192.168.0.0/12 | 用户网段,如需定义多个网段请使用半角逗号(,)隔开,最多支持3个网段。 关于用户网段的详细信息,请参见专有网络FAQ的 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 | 客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。 |
Ipv6Isp | String | 否 | BGP | VPC的IPv6地址段类型。取值:
说明 如果是开通了单线带宽白名单的用户,该字段可以设置为ChinaTelecom(中国电信)、ChinaUnicom(中国联通)或ChinaMobile(中国移动)。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
VpcId | String | vpc-bp15zckdt37pq72zv**** | 创建的VPC的ID。 |
VRouterId | String | vrt-bp1lhl0taikrteen8**** | 创建VPC后,系统自动创建的路由器的ID。 |
RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 | 请求ID。 |
RouteTableId | String | vtb-bp145q7glnuzdv**** | 创建VPC后,系统自动创建的路由表的ID。 |
ResourceGroupId | String | rg-acfmxazb4ph6aiy**** | 资源组ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/12
&Ipv6CidrBlock=2408:XXXX:0:6a::/56
&EnableIpv6=false
&VpcName=abc
&Description=This is my first Vpc
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&DryRun=false
&UserCidr=192.168.0.0/12
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6Isp=BGP
&公共请求参数
正常返回示例
XML
格式
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
格式
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****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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描述的格式不符合要求。 |
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重叠。 |
400 | InvalidResourceGroupId | The specified ResourceGroupId does not exist. | 资源组ID不存在。 |
400 | OperationUnsupported.ResourceGroupId | ResourceGroup is not supported in this region. | 资源组功能未打开。 |
400 | ResourceNotEnough.Ipv6Cidr | The specified resource of Ipv6Cidr is not enough. | Ipv6地址资源不足。 |
404 | InvalidRegionId.NotFound | Specified value of "regionId" is not supported. | 指定的 RegionId 不存在,请您检查此产品在该地域是否可用。 |
500 | InternalError | The request processing has failed due to some unknown error. | 请求处理由于某些未知错误失败。 |
访问错误中心查看更多错误码。