创建子网
更新时间：2025-08-05
接口描述
本接口用来在VPC中创建子网。
请求结构
Plain Text
1 POST /v1/vpc/subnet HTTP/1.1
2 Host: bec.baidubce.com
3 Authorization: authorization string
4
5 {
6 "name": "subnet1",
7 "description": "",
8 "cidr": "172.17.1.0/24",
9 "vpcId": "vpc-IyrqYIQ7",
10 "tags": [
11 {
12 "tagKey": "",
13 "tagValue": ""
14 }
15 ]
16 }
17 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | String | 是 | Request Body参数 | 子网名称，不能取值“default”，长度不超过65个字符，可由数字、字符、下划线组成 |
| cidr | String | 是 | Request Body参数 | 子网CIDR，必须属于VPC内的有效网段 |
| vpcId | String | 是 | Request Body参数 | 子网所属VPC的ID |
| description | String | 否 | Request Body参数 | 描述，不超过200字符 |
| tags | List<TagModel> | 否 | RequestBody参数 | 标签信息 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| action | String | 创建操作，返回为"create" |
| result | Boolean | 操作是否成功，true表示成功；false表示失败 |
| details | Map | 返回结果，包含subnetId，表示子网ID，类型为String |
请求示例
Plain Text
1 POST /v1/vpc/subnet HTTP/1.1
2 Host: bec.baidubce.com
3 ContentType: application/json
4 Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/uuid
5
6 {
7 "name": "subnet1",
8 "description": "",
9 "cidr": "192.168.0.0/24",
10 "vpcId": "vpc-pnqfsbl4"
11 }
12 返回示例
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
3 Date: Thu, 16 Mar 2021 06:29:48 GMT
4 Content Type: application/json;charset=UTF 8
5 Server: BWS
6
7 {
8 "result": true,
9 "action": "create",
10 "details": {
11 "subnetId": "sbn-id5onybc"
12 }
13 }Model对象定义
TagModel
| 参数名称 | 类型 | 描述 |
|---|---|---|
| tagKey | String | 标签键 |
| tagValue | String | 标签值 |