Release a CDS disk (new)
Updated at:2025-10-20
This API is used to release unmounted CDS data disks. System disks, however, cannot be released.
- After a disk is released, it cannot be recovered. By default, all disk snapshots will be kept, but their association with the disk will be removed.
- 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.
- When you use this API, snapshots are not deleted by default, and the disk will not enter the recycle bin. To delete associated snapshots or place the disk in the recycle bin, please use the updated API.
Request structure
Plain Text
1DELETE /v{version}/volume/{volumeId} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
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 |
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
1DELETE /v2/volume/v-3zmCcxbR HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
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
