Release the CDS Disk(New)
Last Updated：2020-07-20
Description
- This API is used to release the unmounted CDS disk. The system disk can not be released.
- The disk can not be recovered after release. You can specify whether the snapshot associated with the disk is deleted. All snapshots of this disk are retained by default, but the association with this disk is deleted.
- This operation can be performed only when the disk is in the Available or Expired or Error status. Otherwise, it prompts an error 409.
- If the disk with volumeid does not exist, it prompts an error 404.
- The difference from the original interface is that it can control whether the snapshot associated with the disk is deleted.
Request Structure
POST /v{version}/volume/{volumeId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"autoSnapshot": "on",
"manualSnapshot": "on"
}Request Header Field
There are no other special header fields except the public header field.
Request Parameters
| Parameter Name | Type | Required | Parameter Position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| volumeId | String | Yes | URL parameter | Disk ID to release |
| autoSnapshot | String | No | Request Body Parameter | When the value is "On", delete the automatic snapshot associated with the disk. |
| manualSnapshot | String | No | Request Body Parameter | When the value is "On", delete the manual snapshot associated with the disk. |
Return Header Field
There are no other special header fields except the common header field.
Return Parameter
No specific parameters are returned.
Error Code
| Error Code | Error Description | HTTP Status Code | Explanations |
|---|---|---|---|
| Volume.DiskStatusCannotBeDeleted | Volume in current status can not be deleted. | 409 | The disk can not be deleted in current status. |
| Volume.SystemDiskCannotBeDeleted | System disk can not be deleted. | 403 | The system disk can not be deleted. |
Request Instance
POST /v2/volume/v-3zmCcxbR HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"autoSnapshot": "on",
"manualSnapshot": "on"
}Return Instance
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS