调用DeleteDisk释放一块按量付费数据盘。磁盘类型包括普通云盘、高效云盘、SSD云盘和ESSD云盘。
接口说明
调用该接口时,您需要注意:
- 您的磁盘手动快照会被保留。
- 您可以通过ModifyDiskAttribute设置是否保留或者同时释放自动快照。建议您及时删除不必要的快照,以保持足够的快照额度完成周期性的自动快照策略。
- 释放磁盘时,云盘的状态必须为待挂载(Available)。
- 如果指定ID的磁盘不存在,请求将被忽略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteDisk | 系统规定参数。取值:DeleteDisk |
DiskId | String | 是 | d-bp14k9cxvr5uzy5**** | 需要释放的云盘设备ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DeleteDisk &DiskId=d-bp14k9cxvr5uzy5**** &<公共请求参数>
正常返回示例
XML
格式
<DeleteDiskResponse> <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId> </DeleteDiskResponse>
JSON
格式
{ "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984" }
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | IncorrectDiskStatus | The current disk status does not support this operation. | 当前的磁盘不支持此操作,请您确认磁盘处于正常使用状态,是否欠费。 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
403 | DiskNotPortable | The specified disk is not a portable disk. | 指定的磁盘不是可卸载的磁盘,Portable为false的磁盘无法卸载。 |
403 | DiskTypeViolation | The specified disk is a system disk and cannot support the operation. | 指定的云盘是系统盘,不能卸载。 |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | 指定的磁盘正在创建快照。 |
403 | IncorrectDiskStatus.Initializing | The current disk status does not support this operation. | 当前的磁盘不支持此操作,请您确认磁盘处于正常使用状态,是否欠费。 |
404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盘不存在。请您检查磁盘ID是否正确。 |
403 | DiskStillAttached | The disk is still attached to the disk. | 磁盘仍然挂载在实例上。 |
403 | UserNotInTheWhiteList | The user is not in disk white list. | 您不在磁盘白名单中,请加入白名单后重试。 |
400 | InvalidRegionId.MalFormed | The specified parameter RegionId is not valid. | 指定的RegionId不合法。 |
访问错误中心查看更多错误码。