租户端 网络 私有网络（VPC） 历史版本（V2接口）

创建私有网络

最近更新时间: 2024-06-12 15:06:00

1. 接口描述

本接口(CreateVpc)用于创建私有网络。

接口请求域名：vpc.api.qcloud.com

1) 用户可以创建的最小网段子网掩码为28（有16个IP地址），最大网段子网掩码为16（65,536个IP地址）,如果规划VPC网段请参见VPC网段规划说明。 2) 创建VPC时可同时把子网创建好，创建子网也请规划好子网网段及子网所在可用区，同一个VPC内子网网段不能重叠，不同可用区可以做跨可用区容灾，详见VPC可用区说明。 3) 如果您同时创建了子网，系统会创建一个默认路由表，系统会把子网关联到这个默认路由表。 4) 同一个地域能创建的VPC资源个数也是有限制的，详见VPC使用限制,如果需要扩充请联系在线客服。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见公共请求参数页面。其中，此接口的Action字段为CreateVpc。

参数名称 是否必选 类型 描述
vpcName 是 String 私有网络名称，可任意命名，但不得超过60个字符。
cidrBlock 是 String VPC网段,可选值 10.0.0.0/16、172.16.0.0/16和192.168.0.0/16及它们包含的子网，详见VPC网段规划说明。
subnetSet.n 否 Array 子网信息数组，创建VPC时可以同时创建子网，可选项。
subnetSet.n.subnetName 否 String 子网名称，可任意命名，但不得超过60个字符。
subnetSet.n.cidrBlock 否 String 子网网段，子网网段必须在VPC网段内，相同VPC内子网网段不能重叠。
subnetSet.n.zoneId 否 String 子网所在的可用区ID，不同子网选择不同可用区可以做跨可用区灾备，取值详见VPC可用区说明。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功，其他值表示失败。详见错误码页面的公共错误码。
message String 模块错误信息描述，与接口相关。
vpcId String 系统分配的vpcId，示例：gz_vpc_226。
unVpcId String 系统分配的VPC统一ID，由vpcId升级而来，为了兼容这两种ID系统都支持，推荐使用统一ID，示例：vpc-2ari9m7h。
vpcCreateTime String VPC的创建时间，示例:2015-11-06 11:33:52。
subnetSet.n Array 子网信息，同时添加了子网时才会返回。
subnetSet.n.subnetId String 系统分配的子网ID，示例:subnetId_GZ_23。
subnetSet.n.unSubnetId String 系统分配的子网统一ID，由子网ID升级而来，为了兼容这两种ID系统都支持，示例:subnet-5gu2jxf4。
subnetSet.n.routeTableId String 子网绑定的默认路由表ID，示例:gz_rtb_8751。
subnetSet.n.subnetName String 子网名称。
subnetSet.n.cidrBlock String 子网网段，示例:192.168.0.0/25。
subnetSet.n.zoneId String 子网所在可用区ID,示例:200001。
subnetSet.n.zone String 子网所在可用区ID,示例:ap-guangzhou-1。
routeTableSet.n Array 路由表信息，子网默认关联到默认路由表。
routeTableSet.n.routeTableId String 系统分配的路由表ID，示例:gz_rtb_8751。
routeTableSet.n.routeTableType Int 路由表类型，0：普通路由表；1：默认路由表。
routeTableSet.n.routeTableName String 路由表名称。

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码，更多公共错误码详见公共错误码。

错误码 描述
InvalidVpcName VPC名称不合法，可任意命名，但不得超过60个字符。
InvalidVpcCidr vpc CIDR不合法，vpc CIDR取值范围：10.0.0.0/16、172.16.0.0/16和192.168.0.0/16及它们包含的子网，详见VPC网段规划说明。
VpcLimitExceeded 您已经达到指定区域vpc资源申请数量上限，如果需要更多资源，请联系客服申请。更多VPC资源限制信息详见VPC使用限制。
InvalidVpc.NotFound 无效的VPC,VPC资源不存在，请再次核实您输入的资源信息是否正确。

5. 示例

输入

  https://vpc.api.qcloud.com/v2/index.php?Action=CreateVpc
  &<公共请求参数>
  &vpcName=bbbtest
  &cidrBlock=192.168.0.0/16
  &subnetSet.0.subnetName=wikitest
  &subnetSet.0.cidrBlock=192.168.1.0/24
  &subnetSet.0.zoneId=800001

输出


{
    "code": 0,
    "message": "",
    "vpcId": "gz_vpc_266",
    "uniqVpcId": "vpc-2ari9m7h",
    "vpcCreateTime": "2015-11-06 11:33:52",
    "subnetSet": [
        {
            "subnetId": "gz_subnet_18720",
            "unSubnetId": "subnet-5gu2jxf4",
            "routeTableId": "gz_rtb_8751",
            "subnetName": "wikitest",
            "cidrBlock": "192.168.1.0/24",
            "zoneId": 800001
        }
    ],
    "routeTableSet": [
        {
            "routeTableId": "gz_rtb_8751",
            "routeTableType": 1,
            "routeTableName": "默认"
        }
    ]
}