Create a PrivateZone
Updated at：2025-11-11
API description
Create a PrivateZone.
Request structure
Plain Text
1POST /v{version}/privatezone?clientToken={clientToken} HTTP/1.1
2Host: privatezone.baidubce.com
3Authorization: authorization string
4{
5 "zoneName": {zoneName}
6}Request headers
No additional headers beyond standard ones.
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 Support](DNS/API Reference/General Description.md#Idempotence) |
| zoneName | String | Yes | Request Body parameters | Zone name, consisting of two or more letters or numbers, with a maximum length not exceeding 240 characters |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| zoneId | String | Zone ID |
Request example
Plain Text
1POST /v1/privatezone?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849
2Authorization: bce-auth-v1/2edaa258361a11e8912505e5e0ae9978/2018-04-02T02:06:35Z/3600/host;x-bce-date/afb3250d451c9fcfcf1ab6448582df5d6c67899c53bfaf7f51af883e19dc2879
3Host: privatezone.baidubce.com
4{
5 "zoneName":"baidu.com"
6}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 27e9a3a5-989a-48b8-9833-aacc732f7cba
3Date: Tue, 22 May 2018 02:06:36 GMT
4Server: BWS
5Content-Type: application/json;charset=UTF-8
6{
7 "zoneId":"zone-jkgdns3h"
8}