全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
专有网络 VPC

新建专有网络

更新时间:2017-08-30 16:44:46

描述

在指定的地域创建 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 包含的云产品实例不能分布在不同地域,可以分布在同一地域的不同可用区内
  • 每个 VPC 包含的云产品实例数量不超过 10000 个
  • 创建 VPC 时,会自动创建 1 个虚拟路由器和 1 个路由表。每个 VPC 只允许有 1 个虚拟路由器和 1 个路由表
  • 每个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
VpcName String VPC 名称,不填则为空,默认值为空。长度范围为2~128个字节。支持英文或中文字符,必须以大小写字母或中文开头,可包含数字, “_” 或 “-” ,不能以 “http://” 或“https://” 开头
Description String 对新建 VPC 的描述,不填则为空,默认值为空。长度范围为2~256个字节。支持英文或中文字符,不能以 “http://” 或“https://” 开头
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符,具体参见如何保证幂等性
UserCidr String 用户侧网络的网段,如需定义多个网段请使用用半角逗号字符隔开,最多支持3个网段

返回参数

名称 类型 描述
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 VPC 名称格式不正确
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 网段重叠

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=CreateVpc
  2. &RegionID=cn-beijing
  3. &<公共请求参数>

返回示例

XML格式

  1. <CreateVpcResponse>
  2. <RequestId>461D0C42-D5D1-4009-9B6A-B3D5888A19A9</RequestId>,
  3. <RouteTableId>vtb-25wm68mnh</RouteTableId>
  4. <VRouterId>vrt-25bezkd03</VRouterId>
  5. <VpcId>vpc-257gq642n</VpcId>
  6. </CreateVpcResponse>

JSON格式

  1. {
  2. "RequestId": "461D0C42-D5D1-4009-9B6A-B3D5888A19A9",
  3. "RouteTableId": "vtb-25wm68mnh",
  4. "VRouterId": "vrt-25bezkd03",
  5. "VpcId": "vpc-257gq642n"
  6. }
本文导读目录