CreateDefaultVpc - 创建一个默认的VPC - 专有网络 VPC

创建一个默认的专有网络VPC。

接口说明

调用该接口创建默认 VPC 时，请注意：

默认 VPC 创建后无法修改网段，但可以添加附加 IPv4 网段。
每个默认 VPC 支持云资源使用的私网网络地址数量为 300,000 个，且无法提升配额。
创建默认 VPC 后，会自动创建一个路由器和一个路由表。
每个默认 VPC 支持三个用户侧网段。如果多个用户侧网段之间存在包含关系，掩码较短的网段实际生效。例如 10.0.0.0/16 和 10.0.0.0/24 中，10.0.0.0/16 实际生效。
CreateDefaultVpc 接口属于异步接口，即系统会返回一个实例 ID，但该默认 VPC 尚未创建完成，系统后台的创建任务仍在进行。您可以调用 DescribeVpcAttribute 查询默认 VPC 的创建状态：
- 当默认 VPC 处于 Pending 状态时，表示默认 VPC 正在配置中。
- 当默认 VPC 处于 Available 状态时，表示默认 VPC 可用。
CreateDefaultVpc 接口不支持在同一地域内并发创建默认 VPC。
一个地域当前只能有一个默认 VPC。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vpc:CreateDefaultVpc

create

*VPC

acs:vpc:{#regionId}:{#accountId}:vpc/*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	默认 VPC 所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-hangzhou
Ipv6CidrBlock	string	否	默认 VPC 的 IPv6 网段。说明当 EnableIpv6 取值为 true 时，需要输入该参数。	2408:XXXX:346:b600::/56
EnableIpv6	boolean	否	是否开启 IPv6 网段。取值： false（默认值）：不开启。 true：开启。	false
ResourceGroupId	string	否	资源组 ID。	rg-acfmystnjq4****
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-426655440000

返回参数

名称	类型	描述	示例值
	object	创建的默认 VPC 的 ID。
VpcId	string	创建的默认 VPC 的 ID。	vpc-bp15zckdt37pq72zv****
VRouterId	string	创建默认 VPC 后，系统自动创建的路由器的 ID。	vrt-bp1lhl0taikrteen8****
RequestId	string	请求 ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
RouteTableId	string	创建默认 VPC 后，系统自动创建的路由表的 ID。	vtb-bp1q1uirugzb1x32m****

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	TOKEN_PROCESSING	Action is processing.
400	InvokeError	instance quota rule invoke error.	获取规则数据失败，请稍后再试
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.
400	InvalidVpcDiscription.Malformed	Specified VPC description is not valid.
400	QuotaExceeded.Vpc	VPC quota exceeded.	用户名下的VPC数量达到配额上限。
400	ResourceNotAvailable.Vpc	Resource you requested is not available in this region or zone.
400	InvalidUserCidr.Quota	Specified UserCidr number is greater than 3.
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	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.IPv6CidrNotReserved	%s
400	MissingParam.EnableIpv6	%s
400	OperationUnsupported.Ipv6Feature	%s
400	IllegalParam.ZoneId	%s
400	OperationFailed.DefaultVpcExist	%s
400	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.
500	InternalError	The request processing has failed due to some unknown error.
403	Forbbiden	User not authorized to operate on the specified resource.	用户没有权限操作指定的资源。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。