新建专有网络
描述
在指定的地域创建 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] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，磁盘描述会展示在控制台。不能以 http:// 和 https:// 开头 |
| Description | String | 否 | 描述，不填则为空，默认值为空，[2, 256] 英文或中文字符，不能以 http:// 和 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
&<公共请求参数>
返回示例
时间： 2024-12-13 08:34:42