批量创建子网

最近更新时间:2019-01-17 20:24:03

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 。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateSubnets
Version String 公共参数,本接口取值:2017-03-12
Region String 公共参数,详见产品支持的地域列表
VpcId String VPC实例ID。形如:vpc-6v2ht8q5
Subnets.N Array of SubnetInput 子网对象列表。

3. 输出参数

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

4. 示例

示例1 1

输入示例

https://vpc.tencentcloudapi.com/?Action=CreateSubnets
&Version=2017-03-12
&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
&<公共请求参数>

输出示例

{
  "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",
        "AvailableIpAddressCount": 253
      },
      {
        "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",
        "AvailableIpAddressCount": 253
      }
    ],
    "RequestId": "158ac65e-d504-42f6-baac-b716f5855254"
  }
}

5. 开发者资源

API Explorer

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

SDK

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

命令行工具

6. 错误码

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

错误码 描述
InvalidParameterValue.SubnetConflict 子网CIDR冲突。
InvalidParameterValue.SubnetRange 子网CIDR不合法。
LimitExceeded 超过配额限制。
ResourceNotFound 资源不存在。

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >