文档

DetachDisk - 卸载按量付费数据盘或系统盘

更新时间:

调用DetachDisk从一台ECS实例上卸载一块按量付费数据盘,或者卸载一块系统盘。

接口说明

调用该接口时,请注意:

  • 磁盘必须已经挂载到实例上,状态为使用中(In_use)。
  • 卸载数据盘时,所挂载的实例必须处于运行中Running)或者已停止Stopped)状态。
  • 卸载系统盘时,所挂载的实例必须处于已停止Stopped)状态。
  • 所挂载的实例被安全控制后,OperationLocks中不能标记为"LockReason" : "security"的锁定状态。
  • DetachDisk 是异步操作,调用接口成功后等待一分钟左右才能完成卸载。
  • 弹性临时盘一旦卸载,只能重新挂载至其原始实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:DetachDiskupdate
  • Disk
    acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}
  • Instance
    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

请求参数

名称类型必填描述示例值
InstanceIdstring

待卸载的 ECS 实例 ID。

i-bp67acfmxazb4p****
DiskIdstring

待卸载的磁盘 ID。

d-bp67acfmxazb4p****
DeleteWithInstanceboolean

卸载系统盘或数据盘时,设置自动释放属性。表示释放 ECS 实例时,是否同时释放该系统盘或数据盘。

  • true:释放。
  • false:不释放。云盘被转换为按量付费数据盘被保留下来。

默认值:true

您需要注意:

  • 开启多重挂载特性的云盘,不支持设置该参数。
  • 如果卸载的是数据盘,默认值为false
  • 若您需要卸载的目标磁盘为弹性临时盘,则必须将DeleteWithInstance参数设置为true
false

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe input parameter is mandatory for processing this request is empty.参数不能为空。
400InvalidRegionId.MalFormedThe specified RegionId is not valid.指定的地域不存在,请检查该参数是否正确。
400InvalidOperation.InstanceTypeNotSupportThe instance type of the specified instance does not support hot detach disk.磁盘挂载的实例不支持磁盘热插拔操作。
400DisksDetachingOnEcsExceededThe number of disks detaching on the instance exceeds the limit.实例上正在卸载的磁盘个数超过限制
403IncorrectDiskStatusThe current disk status does not support this operation.当前的磁盘不支持此操作,请您确认磁盘处于正常使用状态,是否欠费。
403DiskNotPortableThe specified disk is not a portable disk.指定的磁盘不是可卸载的磁盘,Portable 为 false 的磁盘无法卸载。
403InstanceLockedForSecurityThe instance is locked due to security.您的资源被安全锁定,拒绝操作。
403DependencyViolationThe specified disk has not been attached on the specified instance.资源有其它依赖无法执行操作,请先将依赖取消关联。如:指定磁盘没有挂载在指定的实例上;指定安全组内有实例时无法删除安全组等。
403DiskTypeViolationThe specified disk is a system disk and cannot support the operation.指定的云盘是系统盘,不能卸载。
403IncorrectInstanceStatusThe current status of the resource does not support this operation.该资源目前的状态不支持此操作。
403UserNotInTheWhiteListThe user is not in disk white list.您不在磁盘白名单中,请加入白名单后重试。
403InvalidInstance.ImageCategoryThe image category of the specified instance does not support detaching system disk.指定实例的镜像状态不支持卸载指定的系统盘。可能原因:创建实例时使用的镜像被删除。
403DeleteWithInstance.ConflictMulti attach disk cannot be set to DeleteWithInstance attribute.开启多重挂载特性的云盘不支持设置 DeleteWithInstance。
403InvalidOperation.DiskCategoryUnsupportedThe DetachDisk operation is not supported for elastic ephemeral disk.弹性临时盘不支持单独卸载
403InvalidParameter.DeleteWithInstanceThe DeleteWithInstance for the elastic ephemeral disk must be set to true.弹性临时盘的 DeleteWithInstance 属性必须设置为 true。
403InvalidOperation.DiskDetachingFromThisEcsThe specified disk is detaching from this ecs.磁盘正在从当前实例上卸载。
404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.指定的实例ID未找到。
404InvalidDiskId.NotFoundThe specified disk does not exist.指定的磁盘不存在。请您检查磁盘 ID 是否正确。
404InvalidDisk.AlreadyDetachedThe specified disk has been detached.指定的磁盘已分离。
404InvalidDiskId.OperationNotSupportedThe operation is not supported due to base image not exist.-
500InternalErrorThe request processing has failed due to some unknown error.内部错误,请重试。
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.内部错误,请重试。

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

变更历史

变更时间变更内容概要操作
2024-09-20OpenAPI 错误码发生变更查看变更详情
2024-07-24OpenAPI 错误码发生变更查看变更详情
2024-05-09OpenAPI 错误码发生变更查看变更详情
2024-04-15OpenAPI 错误码发生变更查看变更详情
2023-11-24OpenAPI 错误码发生变更查看变更详情