Get Purchasable Disk Information
Updated at：2025-10-20
This API retrieves purchasable disk types, sizes, and quota limits based on availability zones.
Request structure
Plain Text
1GET /v{version}/volume/disk?zoneName={zoneName}&clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number. |
| clientToken | String | Yes | Query | Idempotence Token, which is an ASCII string with a length not exceeding 64 bits. For details, see the [Idempotence ](BCC/API Reference/General Description.md#Idempotence). |
| zoneName | String | Yes | Query | Zone information follows the naming convention "country-region-availability zone sequence," using lowercase letters (e.g., Beijing Availability Zone A is "cn-bj-a"). If an empty string or invalid zoneName is entered, information for all availability zones will be returned. |
Response headers
There are no special headers required beyond the common headers.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| cdsRatio | String | Maximum number of disks that can be created for a single BCC |
| cdsTotalCapacityGB | String | Maximum total disk capacity (GB) |
| cdsTotal | String | Count of BCC instances * cdsRatio. Note: This parameter has been deprecated, meaning that the count of CDS purchased by users is no longer limited by the number of BCC instances. The current return value is a fixed value |
| cdsCreated | String | Count of disks already created, including disks in the recycle bin |
| cdsUsedCapacityGB | String | Total used disk capacity (GB) |
| diskZoneResources | [DiskZoneResources](BCC/API Reference/Appendix.md#DiskZoneResources) | Information about disks that can be created in the availability zone; for specific parameters, see [DiskZoneResources](BCC/API Reference/Appendix.md#DiskZoneResources) |
Request example
Plain Text
1GET http://bcc.bj.baidubce.com/v2/volume/disk?zoneName=cn-bj-a&clientToken=3A8d84403************
2Host: bcc.bj.baidubce.com
3Authorization: authorization-stringResponse example
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "cdsRatio": "15",
8 "cdsTotalCapacityGB": "163840",
9 "cdsTotal": "75",
10 "cdsCreated": "0",
11 "cdsUsedCapacityGB": "0",
12 "diskZoneResources": [
13 {
14 "zoneName": "cn-bj-a",
15 "diskInfos": [
16 {
17 "storageType": "premium_ssd",
18 "maxDiskSize": 32765,
19 "minDiskSize": 50
20 },
21 {
22 "storageType": "ssd",
23 "maxDiskSize": 32765,
24 "minDiskSize": 5
25 },
26 {
27 "storageType": "enhanced_ssd_pl1",
28 "maxDiskSize": 32765,
29 "minDiskSize": 5
30 }
31 ]
32 }
33 ]
34}