ReleaseDisk

1. API Description

This API is used to release a disk.

Note

• This operation is irreversible. Once the operation is successful, the disks will be completely released. Please operate with caution.

• Only operations on disks in recycle bin are supported.

• Only operations on data disks are supported.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
diskId	Yes	String	Disk ID.

3. Output Parameters

Parameter Name	Type	Description
requestId	String	The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Code Example

Example

Release a disk.

POST /api/v2/vm HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: ReleaseDisk
<Common Request Params>

Request:
{
  "diskId": "your-disk-id"
}

Response:
{
  "requestId": "T52617F2F-33A3-42EF-B353-CC44271C89E4",
  "response": {
    "requestId": "T52617F2F-33A3-42EF-B353-CC44271C89E4"
  }
}

5. Developer Resources

Zenlayer Cloud API 2.0 integrates SDKs to make it easier for you to call APIs. More programming languages will be supported.

6. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.​

HTTP Status Code	Error Code	Description
404	INVALID_DISK_NOT_FOUND	Disk does not exist.
400	UNSUPPORTED_OPERATION_DISK_NOT_BEING_RECYCLE	Only operations on disks in recycle bin are supported.
400	UNSUPPORTED_OPERATION_DISK_SYSTEM_TYPE	Only operations on data disks are supported.
400	UNSUPPORTED_OPERATION_RECYCLE_STATUS	Operations on the recycle bin with current status are not supported.