创建子网

1. 接口描述

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

本接口（CreateSubnet）用于创建子网。

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

默认接口请求频率限制：100次/秒。

2. 输入参数

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

3. 输出参数

4. 示例

示例1 创建子网

创建子网

输入示例

POST / HTTP/1.1
Host: vpc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSubnet
<公共请求参数>

{
    "SubnetName": "TestSubnet",
    "VpcId": "vpc-m3ul053f",
    "CidrBlock": "10.8.0.0/24",
    "Zone": "ap-guangzhou-1",
    "Tags": [
        {
            "Value": "shanghai",
            "Key": "city"
        }
    ]
}

输出示例

{
    "Response": {
        "Subnet": {
            "VpcId": "vpc-m3ul053f",
            "EnableBroadcast": true,
            "Zone": "1001",
            "IsCdcSubnet": 0,
            "AvailableIpAddressCount": 1021,
            "IsRemoteVpcSnat": true,
            "SubnetName": "subnet1",
            "TotalIpAddressCount": 1024,
            "TagSet": [
                {
                    "Value": "shanghai",
                    "Key": "city"
                }
            ],
            "CreatedTime": "2023-03-21 18:00:00",
            "SubnetId": "subnet-1d32nvu2",
            "CidrBlock": "10.8.0.0/24",
            "IsDefault": false,
            "CdcId": "",
            "Ipv6CidrBlock": "",
            "RouteTableId": "",
            "NetworkAclId": ""
        },
        "RequestId": "9450a158-0487-4baa-bd3f-a07f343b6c4e"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

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

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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