Release a CDS disk
Updated at：2025-10-20
This API is used to release unmounted CDS data disks. System disks, however, cannot be released.
- Users can decide whether to delete snapshots associated with the disk. By default, all disk snapshots will be kept, but their association with the disk will be removed.
- Users can decide whether to move the disk to the recycle bin.
- This operation can only be executed when the disk status is "Available," "Expired," or "Error." Otherwise, a 409 error will be returned.
- If no disk corresponding to the provided volumeId exists, a 404 error will be returned.
- Differences from the previous API: It allows you to control whether snapshots associated with the disk are deleted and whether the disk is moved to the recycle bin.
Request structure
Plain Text
1POST /v{version}/volume/{volumeId} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "autoSnapshot": "on",
7 "manualSnapshot": "on",
8 "recycle": "on",
9 "cdsAttributeActive": cdsAttributeActive
10}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 | API version number |
| volumeId | String | Yes | URL parameter | ID of the disk to be released |
| autoSnapshot | String | No | Request Body parameters | When the value is "on", the automatic snapshots associated with the disk will be deleted |
| manualSnapshot | String | No | Request Body parameters | When the value is "on", the manual snapshots associated with the disk will be deleted |
| recycle | String | No | Request Body parameters | When the value is "on," the data disk will be moved to the recycle bin; when the value is "off," the disk will be deleted immediately. The default value is "on." |
| cdsAttributeActive | boolean | No | Request Body parameters | Whether automatic snapshots are released according to the “automatic snapshots released with disk” attribute; the default is false. When this parameter is true, automatic snapshots will be released according to their associated release attributes, with a higher priority than autoSnapshot |
Response headers
No special headers are required beyond the standard ones.
Response parameters
There are no special response parameters
Error codes
| Error code | Error description | HTTP status code | Chinese explanation |
|---|---|---|---|
| Volume.DiskStatusCannotBeDeleted | Volume in current status can not be deleted. | 409 | The current status of the disk does not allow deletion |
| Volume.SystemDiskCannotBeDeleted | System disk can not be deleted. | 403 | System disks cannot be deleted |
Request example
Plain Text
1POST /v2/volume/v-3zmCcxbR HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: authorization-string
5
6{
7 "autoSnapshot": "on",
8 "manualSnapshot": "on"
9 "recycle": "on",
10 "cdsAttributeActive": false
11}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS