ReleaseDisk

1. API Description

This API (ReleaseDisk) is used to release a disk.

Notes

• A system disk cannot be released. It is released together with the deletion of the instance.

• For a regular account, a disk is released directly after the deletion. Calling this interface on a disk in the recycle bin releases it completely.

• This operation is irreversible, so please proceed with caution.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
diskId	Yes	String	ID of the disk to be deleted. It can be obtained by calling DescribeDisks.

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/zec 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	INVALID_DISK_NOT_PORTABLE	Disk is not detachable.
400	UNSUPPORTED_OPERATION_DISK_STATUS	Operations on the disk with current status are not supported.