调用CreateVpc接口创建一个专有网络(VPC)。
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所在的地域。您可以通过调用DescribeRegions接口获取地域ID。 |
CidrBlock | String | 否 | 172.16.0.0/12 |
VPC的网段。您可以使用以下网段或其子集作为VPC的网段:
|
Ipv6CidrBlock | String | 否 | 2408:4004:0:6axx::/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 | 否 | 189.16.0.0/12 |
用户网段,如需定义多个网段请使用半角逗号隔开,最多支持3个网段。 用户网段的详细信息,请参见网段常见问题中的什么是用户网段。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=CreateVpc
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<CreateVpcResponse>
<ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
<RequestId>8B2F5262-6B57-43F2-97C4-971425462DFE</RequestId>
<RouteTableId>vtb-bp1krxxzp0c2****</RouteTableId>
<VRouterId>vrt-bp1jcg5cmxjbl9xgc****</VRouterId>
<VpcId>vpc-bp1qpo0kug3a20qqe****</VpcId>
</CreateVpcResponse>
JSON
格式
{
"ResourceGroupId": "rg-acfmxazb4ph****",
"RequestId": "8B2F5262-6B57-43F2-97C4-971425462DFE",
"RouteTableId": "vtb-bp1krxxzp0c29****",
"VRouterId": "vrt-bp1jcg5cmxjbl9xgc****",
"VpcId": "vpc-bp1qpo0kug3a20qqe****"
}
错误码
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. | 请求处理由于某些未知错误失败。 |
访问错误中心查看更多错误码。