TerminateDisk

1. 接口描述

本接口(TerminateDisk)用于终止云硬盘。

注意事项

  • 终止的云硬盘将会放入回收站。24小时后云硬盘会自动从回收站中删除。

  • 目前只能终止后付费的云硬盘,预付费云硬盘将会在到期后自动终止。

  • 本接口无法终止系统盘

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称
必选
类型
描述

diskId

String

云硬盘ID。

3. 响应结果

参数名称
类型
描述

requestId

String

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 requestId。

4. 代码示例

  1. 将云硬盘放入回收站。

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

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

Response:
{
  "requestId": "TE2A08EDA-C514-4F82-8D9A-C5BA0A7B1BF3",
  "response": {
    "requestId": "TE2A08EDA-C514-4F82-8D9A-C5BA0A7B1BF3"
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集(SDK),未来会陆续支持更多开发语言,方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码,其他错误码见公共错误码

HTTP状态码
错误码
说明

404

INVALID_DISK_NOT_FOUND

指定的云硬盘不存在。

400

UNSUPPORTED_OPERATION_DISK_SYSTEM_TYPE

指定的云硬盘为系统盘不支持该操作。

404

INVALID_ORDER_NOT_FOUND

指定的订单不存在。

400

UNSUPPORTED_OPERATION_DISK_BEING_RECYCLE

指定的云硬盘正在回收中不支持该操作。

400

UNSUPPORTED_OPERATION_INSTANCE_CHARGE_TYPE

实例的计费类型不支持该操作。

400

UNSUPPORTED_OPERATION_DISK_STATUS

指定云硬盘的状态不支持该操作。

最后更新于