CreateVpc_专有网络_API文档-阿里云OpenAPI开发者门户

接口说明

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

一个 VPC 只能指定一个网段。
VPC 创建后无法修改网段，但可以添加附加 IPv4 网段。
每个 VPC 支持云资源使用的私网网络地址数量为 300,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。

流控信息

请求速率为300/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

vpc:CreateVpc	Create	VPC acs:vpc:{#regionId}:{#accountId}:vpc/*	无	无

请求参数

字段名称	字段详情
RegionIdstring	VPC 所在的地域 ID。展开详情示例值:cn-hangzhou参考取值来源: DescribeRegions
CidrBlockstring	VPC 的网段。展开详情示例值:172.16.0.0/12参考取值来源: AssociateVpcCidrBlock AllocateVpcIpv6Cidr AddPublicIpAddressPoolCidrBlock ListPublicIpAddressPoolCidrBlocks
Ipv6CidrBlockstring	VPC 的 IPv6 网段。示例值:2408:XXXX:0:6a::/56参考取值来源: AllocateVpcIpv6Cidr
VpcNamestring	VPC 的名称。展开详情示例值:abc参考取值来源: DescribeVpcs
EnableIpv6boolean	是否开启 IPv6 网段。取值：展开详情示例值:false
Descriptionstring	VPC 的描述信息。展开详情示例值:This is my first Vpc
ResourceGroupIdstring	资源组 ID。展开详情示例值:rg-acfmxazb4ph6aiy****
Tagarray<object>	资源的标签。子级条数 <= 21
DryRunboolean	是否只预检此次请求。取值：展开详情示例值:false
UserCidrstring	用户网段，如需定义多个网段请使用半角逗号（,）隔开，最多支持 3 个网段。展开详情示例值:192.168.0.0/12
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:123e4567-e89b-12d3-a456-426655440000
Ipv6Ispstring	VPC 的 IPv6 地址段类型。取值：展开详情示例值:BGP
Ipv4IpamPoolIdstring	IPv4 类型的 IPAM 地址池实例 ID。示例值:ipam-pool-sycmt3p2a9v63i****
Ipv4CidrMaskinteger<int32>	通过输入掩码的方式从 IPAM 地址池分配 VPC。展开详情示例值:12
EnableDnsHostnameboolean	是否启用 DNS 主机名功能。取值：展开详情示例值:false

返回参数

字段名称	字段详情
VpcIdstring	创建的 VPC 的 ID。示例值:vpc-bp15zckdt37pq72zv****
VRouterIdstring	创建 VPC 后，系统自动创建的路由器的 ID。示例值:vrt-bp1lhl0taikrteen8****
RequestIdstring	请求 ID。示例值:0ED8D006-F706-4D23-88ED-E11ED28DCAC0
RouteTableIdstring	创建 VPC 后，系统自动创建的路由表的 ID。示例值:vtb-bp145q7glnuzdv****
ResourceGroupIdstring	资源组 ID。示例值:rg-acfmxazb4ph6aiy****

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

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.	诊断
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.	诊断
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	诊断
400	IllegalParam.Ipv6CidrBlock	%s	诊断
400	OperationFailed.IPv6CidrNotReserved	%s	诊断
400	MissingParam.EnableIpv6	%s	诊断
400	OperationUnsupported.Ipv6Feature	%s	诊断
400	System.ServiceBusy	System is busy, please try later.	诊断
400	IllegalParam.UserCidr	UserCidr is not a valid or strict address.	诊断
400	OperationUnsupported.ResourceGroupId	ResourceGroup is not supported in this region.	诊断
400	IllegalParam.EnableIpv6	%s	诊断
400	InvalidIpv6CidrBlock.Malformed	Specified Ipv6CidrBlock is not valid.	诊断
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	诊断
400	ResourceNotEnough.Ipv6Cidr	The specified resource of Ipv6Cidr is not enough.	诊断
400	UnsupportedFeature.IPAM	VPCs cannot be created by using IPAM.	诊断
400	IllegalParam.Ipv4CidrMask	The specified Ipv4CidrMask is illegal.	诊断
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.	诊断
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	诊断
400	OperationDenied.IpamPoolNotInRegion	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.	诊断
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	诊断
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	诊断
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	诊断
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.	诊断
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	诊断
400	IllegalParam.CidrBlockMask	The param of CidrBlock Mask [%s] is illegal.	诊断
400	UnsupportedFeature.VpcDnsHostname	The feature of vpc dns hostname is unsupported.	诊断
403	Forbidden	User not authorized to operate on the specified resource.	诊断
404	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.	诊断
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	诊断
500	InternalError	The request processing has failed due to some unknown error.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-01-16	变更错误码400
	2024-12-18	变更错误码400
	2024-10-10	新增请求参数EnableDnsHostname
	2024-08-27	新增请求参数EnableDnsHostname
	2024-05-21	变更错误码400
	2024-04-25	变更错误码400 变更错误码404 新增请求参数Ipv4CidrMask
	2023-07-05	新增请求参数Tag

1
2
10 条/页

CreateVpc_专有网络_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例