API文档

批量创建子网

最近更新时间:2020-09-09 08:11:45

1. 接口描述

接口请求域名: vpc.tencentcloudapi.com 。

本接口(CreateSubnets)用于批量创建子网。

  • 创建子网前必须创建好 VPC。
  • 子网创建成功后,子网网段不能修改。子网网段必须在VPC网段内,可以和VPC网段相同(VPC有且只有一个子网时),建议子网网段在VPC网段内,预留网段给其他子网使用。
  • 您可以创建的最小网段子网掩码为28(有16个IP地址),最大网段子网掩码为16(65,536个IP地址)。
  • 同一个VPC内,多个子网的网段不能重叠。
  • 子网创建后会自动关联到默认路由表。
  • 创建子网同时可以绑定标签, 应答里的标签列表代表添加成功的标签。

默认接口请求频率限制:20次/秒。

注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:vpc.ap-shanghai-fsi.tencentcloudapi.com。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateSubnets。
Version String 公共参数,本接口取值:2017-03-12。
Region String 公共参数,详见产品支持的 地域列表
VpcId String VPC实例ID。形如:vpc-6v2ht8q5
Subnets.N Array of SubnetInput 子网对象列表。
Tags.N Array of Tag 指定绑定的标签列表,注意这里的标签集合为列表中所有子网对象所共享,不能为每个子网对象单独指定标签,例如:[{"Key": "city", "Value": "shanghai"}]

3. 输出参数

参数名称 类型 描述
SubnetSet Array of Subnet 新创建的子网列表。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 批量创建子网

输入示例

https://vpc.tencentcloudapi.com/?Action=CreateSubnets
&VpcId=vpc-6v2ht8q5
&Subnets.0.CidrBlock=10.4.14.0/24
&Subnets.0.SubnetName=t1
&Subnets.0.Zone=ap-guangzhou-2
&Subnets.1.CidrBlock=10.4.15.0/24
&Subnets.1.SubnetName=t2
&Subnets.1.Zone=ap-guangzhou-3
&Tags.0.Key=city
&Tags.0.Value=shanghai
&<公共请求参数>

输出示例

{
  "Response": {
    "SubnetSet": [
      {
        "VpcId": "vpc-6v2ht8q5",
        "SubnetId": "subnet-bxxo9gik",
        "SubnetName": "t1",
        "CidrBlock": "10.4.14.0/24",
        "IsDefault": false,
        "EnableBroadcast": false,
        "Zone": "ap-guangzhou-2",
        "RouteTableId": "rtb-3ryrwzuu",
        "CreatedTime": "2018-11-29 19:16:45",
        "TotalIpAddressCount": 253,
        "AvailableIpAddressCount": 253,
        "TagSet": [
          {
            "Key": "city",
            "Value": "shanghai"
          }
        ]
      },
      {
        "VpcId": "vpc-6v2ht8q5",
        "SubnetId": "subnet-f84xsjpa",
        "SubnetName": "t2",
        "CidrBlock": "10.4.15.0/24",
        "IsDefault": false,
        "EnableBroadcast": false,
        "Zone": "ap-guangzhou-3",
        "RouteTableId": "rtb-3ryrwzuu",
        "CreatedTime": "2018-11-29 19:16:45",
        "TotalIpAddressCount": 253,
        "AvailableIpAddressCount": 253,
        "TagSet": [
          {
            "Key": "city",
            "Value": "shanghai"
          }
        ]
      }
    ],
    "RequestId": "158ac65e-d504-42f6-baac-b716f5855254"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InvalidParameter 参数错误。
InvalidParameterValue.LimitExceeded 参数值超出限制。
InvalidParameterValue.Malformed 入参格式不合法。
InvalidParameterValue.SubnetConflict 子网CIDR冲突。
InvalidParameterValue.SubnetRange 子网CIDR不合法。
LimitExceeded 超过配额限制。
MissingParameter 缺少参数错误。
ResourceNotFound 资源不存在。
目录