Create VPC
Updated at：2025-10-16
Description
Launch a VPC instance.
Request structure
Plain Text
1POST /v{version}/vpc?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "name":"test",
7 "description":"this is a vpc",
8 "cidr":"192.168.0.0/16",
9 "enableIpv6":true，
10 "tags":[
11 {
12 "tagKey":"tagKey",
13 "tagValue":"tagValue"
14 }
15 ]
16}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | For API version No., the current value is 1 |
| clientToken | String | No | Query | Idempotence Token, which is an ASCII string with a length not exceeding 64 bits, see details in [ClientToken Idempotence](VPC/API Reference/General Description.md#Idempotence). |
| name | String | Yes | RequestBody | VPC name, which cannot be set as "default", must not exceed 65 characters, and may consist of numbers, letters, and underscores |
| description | String | No | RequestBody | VPC description, not exceeding 200 characters |
| cidr | String | Yes | RequestBody | VPC CIDR |
| enableIpv6 | Boolean | No | RequestBody | Decide whether to enable the IPv6 segment. Use "true" to enable or "false" (default) to disable. |
| tags | List<[TagModel](VPC/API Reference/Appendix.md#TagModel)> | No | RequestBody | List of tag key-value pairs to be created |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| vpcId | String | ID of the created VPC |
Request example
Plain Text
1POST /v1/vpc?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "name": "test",
6 "description": "",
7 "cidr": "192.168.0.0/16",
8 "enableIpv6": true
9}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7 "vpcId":"vpc-1849ef6b"
8}