Create a dedicated cluster
Updated at：2025-10-20
This API is used to create a dedicated CDS cluster.
- Dedicated CDS clusters are only available for subscription (prepay) and do not support pay-as-you-go (postpay). Subscription durations include 6 months, 1 year, 2 years, 3 years, and 5 years.
- The cluster's minimum capacity is 85 TB, its maximum capacity is 1,015 TB, and it can be expanded in increments of 10 TB.
- The cluster's region and availability zone cannot be changed after creation. Therefore, plan the regions and availability zones for your cloud resources in advance.
- Due to the large capacity of dedicated CDS clusters, the supply chain may require some lead time for preparation. If needed, contact your account manager to discuss your requirements.
Request structure
Plain Text
1POST /v{version}/volume/cluster HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "zoneName": zoneName,
7 "clusterName": clusterName,
8 "clusterSizeInGB": clusterSizeInGB,
9 "storageType": storageType,
10 "purchaseCount": purchaseCount,
11 "billing": {
12 "paymentTiming": paymentTiming,
13 "reservation": {
14 "reservationLength": reservation,
15 "reservationTimeUnit": reservationTimeUnit
16 }
17 }
18 "tags": [
19 {
20 "tagKey": tagkey,
21 "tagValue": tagvalue
22 }
23 ]
24}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Type | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number. |
| zoneName | String | No | RequestBody | Specified availability zone: By default, this field is empty, and the system will automatically select the zone. |
| clusterName | String | Yes | RequestBody | Name of the dedicated CDS cluster created. |
| clusterSizeInGB | String | Yes | RequestBody | Total cluster capacity is measured in GB, with a minimum of 85 TB, a maximum of 1,015 TB, and a purchase increment of 10 TB. |
| storageType | int | Yes | RequestBody | Type of the dedicated cluster to be created. |
| purchaseCount | int | No | RequestBody | Count of created CDS dedicated clusters, which must be a positive integer greater than 0, defaulting to 1 |
| billing | [Billing](BCC/API Reference/Appendix.md#Billing) | Yes | RequestBody | Order and billing-related parameters |
| tags | List<TagModel > | No | RequestBody | List of tags to be created. For the specific data format, refer to the TagModel |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| clusterIds | Collection of dedicated cluster IDs that comply with BCE specifications. This is a fixed-length string allowing only uppercase and lowercase letters, numbers, hyphens (-), and underscores (_). |
Request example
Plain Text
1 POST /v{version}/volume/cluster HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/******
4 {
5 "zoneName": "cn-bj-b",
6 "clusterName": "",
7 "clusterSizeInGB": 97280,
8 "storageType": "hp1",
9 "purchaseCount": 1,
10 "billing": {
11 "paymentTiming": "Prepaid",
12 "reservation": {
13 "reservationLength": 6,
14 "reservationTimeUnit": "Month"
15 }
16 "tags": [
17 {
18 "tagKey": "key1",
19 "tagValue": "value1"
20 },
21 {
22 "tagKey": "key2",
23 "tagValue": "value2"
24 }
25 ]
26
27 }
28 }Response example
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Mar, 23 Dec 2023 06:42:19 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6 {
7 "clusterIds": [
8 "DC-1ns4****"
9 ]
10 }