新建专有网络
描述
在指定的地域创建 1 个 VPC
VPC 只能指定 1 个 CIDRBlock,CIDRBlock 的范围包括 10.0.0.0 / 8、172.16.0.0 / 12 和 192.168.0.0 / 16 及它们的子网,CIDRBlock 的掩码为 8 - 24 位,默认为 172.16.0.0 / 12
VPC 创建后无法修改 CIDRBlock
每个 VPC 包含的云产品实例不能分布在不同 Region,可以分布在同一 Region 的不同可用区内
每个 VPC 包含的云产品实例数量不超过 5000 个
创建 VPC 时,会自动创建 1 个 VRouter 和 1 个 RouteTable。每个 VPC 只允许有 1 个 VRouter 和 1 个 RouteTable
每个VPC,支持3个用户侧网络的网段 UserCidr ;如果多个用户侧网段之间存在互相包含(比如10.0.0.0/8和10.1.0.0/16,以10.0.0.0/8实际生效)
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数,取值:CreateVpc
RegionId
String
是
新建的 VPC 所在的地域
CidrBlock
String
否
可选值 10.0.0.0/8、172.16.0.0/12和192.168.0.0/16及它们包含的子网。默认是172.16.0.0/12
UserCidr
String
否
用户自定义私网网段(多个 UserCidr 使用用半角逗号字符隔开,最多3个)
VpcName
String
否
VPC 名称,不填则为空,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_”或”-”,磁盘描述会展示在控制台。不能以 // 和 https:// 开头
Description
String
否
描述,不填则为空,默认值为空,[2, 256] 英文或中文字符,不能以 // 和 https:// 开头
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符,具体参见附录
返回参数
名称 |
类型 |
描述 |
VpcId
String
系统分配的专有网络 ID
VRouterId
String
路由器 Id
RouteTableId
String
路由表 Id
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidRegionId.NotFound
Specified value of “RegionId” is not supported.
404
指定的 Region 不存在
InvalidParameter
Specified CIDR block is not valid .
400
指定的网段不正确
ResourceNotAvailable
Resource you requested is not available in this region or zone.
400
指定的 Region 或 Zone 不支持 VPC
InvalidVpcName.Malformed
Specified VPC name is not valid.
400
VPCName 格式不正确
InvalidVpcDiscription.Malformed
Specified VPC description is not valid.
400
指定的 VPC 描述信息不正确
Forbbiden
User not authorized to operate on the specified resource.
403
用户没有指定资源的操作权限
QuotaExceeded.Vpc
VPC quota exceeded.
400
用户名下的 VPC 数量达到配额上限
InvalidParameter
Specified UserCidr invalid format.
400
指定的 UserCidr 格式不合法
InvalidParameter
Specified UserCidr Subnet mask is not valid.
400
指定的 UserCidr 子网掩码不合法
InvalidUserCidr.Quota
Specified UserCidr number is greater than 3.
400
指定的 UserCidr 个数大于3
InvalidUserCidr.Malformed
Specified UserCidr overlapping in of 100.64.0.0/10.
400
指定的 UserCidr 与 100.64.0.0/10 网段重叠
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateVpc
&RegionID=cn-beijing
&<公共请求参数>
返回示例
所属专题: