1. 接口描述
本接口(CreateSubnet)用于创建子网。
接口请求域名：vpc.api.qcloud.com
1. 创建子网前必须创建好 VPC。
2. 子网创建成功后，子网网段不能修改。子网网段必须在 VPC 网段内，可以和 VPC 网段相同（VPC 有且只有一个子网时），建议子网网段在 VPC 网段内，预留网段给其他子网使用。
3. 您可以创建的最小网段子网掩码为28（有16个 IP 地址），最大网段子网掩码为16（65,536个 IP 地址）。
4. 同一个 VPC 内，多个子网的网段不能重叠。
5. 子网创建后会自动关联到默认路由表。
2. 输入参数
参数名称 | 是否必选 | 类型 | 描述 |
vpcId | 是 | String | |
subnetSet.n | 是 | Array | 子网信息数组，创建 VPC 时可以同时创建子网，可选项。 |
subnetSet.n.subnetName | 是 | String | 子网名称，可任意命名，但不得超过60个字符。 |
subnetSet.n.cidrBlock | 是 | String | 子网网段，子网网段必须在 VPC 网段内，相同 VPC 内子网网段不能重叠。 |
subnetSet.n.zoneId | 是 | String |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | |
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 | |
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 | |
InvalidZone.NotFound |
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}]}
