Create Subnet
Last Updated：2021-04-27
Description
Create a subnet in VPC
*If you want to create a subnet in a secondary IP address range in VPC, you are required to fill the parameter vpcSecondaryCidr.
Request structure
POST /v{version}/subnet?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"zoneName": "cn-bj-a",
"subnetType": "BCC",
"name": "subnet",
"description": "", "cidr": "172.17.1.0/24", "vpcId": "vpc-IyrqYIQ7", "tags":[ { "tagKey": tagKey, "tagValue": tagValue } ] }
Request header
There are no other special headers except the public headers.
Request parameter
| Parameter name | Type | Required or not | Parameter position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| clientToken | String | No | Query parameter | Idempotence Token is an ASCII string with length not exceeding 64 bytes, for details, please see ClientToken Idempotence Support |
| name | String | Yes | Request Body parameters | The subnet name cannot take the "default" value, with the length not exceeding 65 characters, and can be composed by numbers, characters and underlines. |
| zoneName | String | Yes | Request Body parameters | For the name of available zone, refer to Query Available Zone List for its query mode. |
| cidr | String | Yes | Request Body parameters | Subnet cidr |
| vpcId | String | Yes | Request Body parameters | Id of vpc to which the subnet belongs |
| vpcSecondaryCidr | String | No | Request Body parameters | CIDR of the secondary IP address range of VPC to which the subnet is affiliated to |
| subnetType | String | No | Request Body parameters | Subnet type, "BCC", "BCC_NAT" and "BBC". |
| description | String | No | Request Body parameters | Description, not exceeding 200 characters |
| tags | List<TagModel> | No | Request Body parameters | List of tag key value pair to be created. |
Return header
There are no other special headers except the public headers.
Return parameter
| Parameter name | Type | Description |
|---|---|---|
| subnetId | String | Create id of subnet. |
Request example
POST /v1/subnet?clientToken=1 HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"zoneName": "cn-bj-a",
"subnetType": "BCC",
"name": "subnet",
"description": "",
"cidr": "192.168.0.0/20",
"vpcId": "vpc-IyrqYIQ7",
"tags":[
{
"tagKey": "tagKey",
"tagValue": "tagValue"
}
]
} Return example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"subnetId":"sbn-1A09ef6b"
}