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

创建子网

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

1. 接口描述

本接口(CreateSubnet)用于创建子网。 接口请求域名：vpc.api.qcloud.com

1) 创建子网前必须创建好 VPC。 2) 子网创建成功后，子网网段不能修改。子网网段必须在VPC网段内，可以和VPC网段相同（VPC有且只有一个子网时），建议子网网段在VPC网段内，预留网段给其他子网使用。 3) 您可以创建的最小网段子网掩码为28（有16个IP地址），最大网段子网掩码为16（65,536个IP地址）。 3) 同一个VPC内，多个子网的网段不能重叠。 4) 子网创建后会自动关联到默认路由表。

2. 输入参数

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

参数名称 是否必选 类型 描述
vpcId 是 String 子网所属的私有网络ID值，可使用vpcId或unVpcId，建议使用unVpcId。可通过 DescribeVpcEx 接口查询。
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 模块错误信息描述，与接口相关。
subnetSet.n Array 子网信息，同时添加了子网时才会返回。
subnetSet.n.subnetId String 系统分配的子网ID，示例:subnetId_GZ_23。
subnetSet.n.unSubnetId String 系统分配的子网统一ID，由子网ID升级而来，为了兼容这两种ID系统都支持，示例:subnet-5gu2jxf4。
subnetSet.n.subnetName String 子网名称。
subnetSet.n.cidrBlock String 子网网段，示例:192.168.0.0/25。
subnetSet.n.routeTableId String 子网绑定的默认路由表ID，示例:gz_rtb_8751。
subnetSet.n.zoneId String 子网所在可用区ID,示例:200001。
subnetSet.n.zone String 子网所在可用区ID,示例:ap-guangzhou-2。

4. 错误码表

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

错误码 描述
InvalidVpc.NotFound 无效的VPC，VPC资源不存在，请再次核实您输入的资源信息是否正确，可通过 DescribeVpcEx 接口查询VPC。
InvalidSubnetName 子网名称不合法，可任意命名，但不得超过60个字符。
InvalidSubnetCidr 子网CIDR不合法或者不在VPC网段内，子网CIDR取值范围：10.0.0.0/16、172.16.0.0/16和192.168.0.0/16及它们包含的子网。
InvalidSubnet.Conflict 子网网段与VPC内其他子网网段冲突。
SubnetLimitExceeded 您已经达到指定区域子网资源申请数量上限，如果需要更多资源，请联系客服申请。更多VPC资源限制信息详见VPC使用限制。
InvalidZone.NotFound 无效的可用区ID，您输入的可用区不存在或者该可用区不支持私有网络，更多可用区信息参见私有网络可用区说明。

5. 示例

输入

  https://vpc.api.qcloud.com/v2/index.php?Action=CreateSubnet
    &<公共请求参数>
  &vpcId=vpc-kd7d06of
  &subnetSet.0.subnetName=tttt
  &subnetSet.0.cidrBlock=10.0.200.0/24
  &subnetSet.0.zoneId=800001

输出

{
    "code": 0,
    "message": "",
    "subnetSet": [
        {
            "subnetId": "gz_subnet_18748",
            "unSubnetId": "subnet-3lzrkspo",
            "routeTableId": "gz_rtb_359",
            "unRouteTableId": null,
            "subnetName": "tttt",
            "cidrBlock": "10.0.200.0\/24",
            "zoneId": 800001
        }
    ]
}