全部产品
云服务器 ECS

DetachDisk

更新时间:2017-09-13 12:57:56   分享:   

描述

Portable 属性为 True 的磁盘,且磁盘所挂载的实例的状态必须为 running 或者 stopped,且实例的 OperationLocks 中没有标记 "LockReason" : "security" 的锁定状态,磁盘可以执行此操作。

当一块独立普通云盘通过这个接口从一台实例上卸载后,DeleteWithInstance 会被置为 False

如果 DiskId 的磁盘不挂载在 InstanceId 的实例上,该操作失败。

该接口是异步操作,请求返回后,仍然需要等待一段时间才能完成卸载,预计在 1 分钟左右。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DetachDisk
InstanceId String 目标云服务器 ID
DiskId String 磁盘 ID

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http状态码 语义
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例不存在
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁盘不存在
IncorrectDiskStatus The current disk status does not support this operation. 403 磁盘状态不正确
DiskNotPortable The specified disk is not a portable disk. 403 指定磁盘不是可卸载的磁盘
InstanceLockedForSecurity The instance is locked due to security. 403 指定的实例被安全锁定
DependencyViolation The specified disk has not been attached on the specified instance. 403 指定磁盘没有挂载在指定的实例上
DiskTypeViolation The specified disk is a system disk and cannot support the operation. 403 指定的磁盘未系统盘不能卸载
InvalidDiskId.Released The specified disk has been released. 403 指定的磁盘已经释放
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 指定的实例状态不对
InvalidParameter The input parameter is mandatory for processing this request is empty. 400 请求缺少必填参数
InvalidDiskId.NotFound The specified DiskId does not exist. 404 指定的磁盘不存在

示例

请求示例

  1. https://ecs.aliyuncs.com/?action=DetachDisk
  2. &InstanceId=i-23jggx34b
  3. &DiskId=d-23jbf2v5m
  4. &<公共请求参数>

返回示例

XML格式

  1. <DetachDiskResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </DetachDiskResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?