阅读367 返回首页    go 阿里云

新建专有网络__专有网络相关接口_API 参考_云服务器 ECS-阿里云

描述

在指定的地域创建 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:// 和 https:// 开头
Description String 否 描述，不填则为空，默认值为空，[2, 256] 英文或中文字符，不能以 https:// 和 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
&<公共请求参数>

返回示例

XML格式

<CreateVpcResponse>
<RequestId>461D0C42-D5D1-4009-9B6A-B3D5888A19A9</RequestId>,
   <RouteTableId>vtb-25wm68mnh</RouteTableId>
   <VRouterId>vrt-25bezkd03</VRouterId>
   <VpcId>vpc-257gq642n</VpcId>
</CreateVpcResponse>

JSON格式

{
  "RequestId": "461D0C42-D5D1-4009-9B6A-B3D5888A19A9",
  "RouteTableId": "vtb-25wm68mnh",
  "VRouterId": "vrt-25bezkd03",
  "VpcId": "vpc-257gq642n"
}

最后更新：2016-11-23 16:03:50

  上一篇：go 撤销出方向安全组规则__安全组相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 删除专有网络__专有网络相关接口_API 参考_云服务器 ECS-阿里云