使用DeleteDisk释放按量付费数据盘-云服务器 ECS-阿里云-云服务器 ECS(ECS)-阿里云帮助中心

释放一块按量付费数据盘。磁盘类型包括普通云盘、高效云盘、SSD云盘和ESSD云盘。

接口说明

调用该接口时，您需要注意：

您的磁盘手动快照会被保留。
您可以通过 ModifyDiskAttribute 设置是否保留或者同时释放自动快照。建议您及时删除不必要的快照，以保持足够的快照额度完成周期性的自动快照策略。
释放磁盘时，云盘的状态必须为待挂载（Available）。
如果指定 ID 的磁盘不存在，请求将被忽略。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DeleteDisk

delete

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

无

名称	类型	必填	描述	示例值
DiskId	string	是	需要释放的云盘设备 ID。	d-bp14k9cxvr5uzy5****

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

异常返回示例

JSON格式

{
    "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

HTTP status code	错误码	错误信息	描述
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	指定的 RegionId 不合法。
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskNotPortable	The specified disk is not a portable disk.
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.
403	DiskStillAttached	The disk is still attached to the disk.
403	UserNotInTheWhiteList	The user is not in disk white list.	您不在磁盘白名单中，请加入白名单后重试。
403	InvalidDiskStatus.DeleteProtection	The specified disk is under delete protection, can not be deleted.	指定的云盘处于删除保护状态。可能原因：该云盘作为系统盘从源实例上卸载，被卸载的系统盘会作为数据盘保留下来。源实例未释放前，被卸载的系统盘无法被主动释放。
404	InvalidDiskId.NotFound	The specified disk does not exist.	指定的磁盘不存在。请您检查磁盘 ID 是否正确。

访问错误中心查看更多错误码。

更多信息，参考变更详情。