卸载磁盘
描述
Portable 属性为 True 的磁盘，且磁盘所挂载的实例的状态必须为 running 或者 stopped，且实例的 OperationLocks 中没有标记 "LockReason" : "security" 的锁定状态，磁盘可以执行此操作。
当一块独立普通云盘通过这个接口从一台实例上卸载后，DeleteWithInstance 会被置为 False。
如果 DiskId 的磁盘不挂载在 InstanceId 的实例上，该操作失败。
该接口是异步操作，请求返回后，仍然需要等待一段时间才能完成卸载，预计在 1 分钟左右。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名，系统规定参数，取值：DetachDisk |
| InstanceId | String | 是 | 目标云服务器 ID |
| DiskId | String | 是 | 磁盘 ID |
返回参数
全是公共返回参数，详见公共返回参数
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| MissingParameter | The input parameter "InstanceId" that is mandatory for processing this request is not supplied. | 400 | InstanceId 未指定 |
| MissingParameter | The input parameter "DiskId" that is mandatory for processing this request is not supplied. | 400 | DiskId 未指定 |
| InvalidInstanceId.NotFound | The specified instance 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 | It 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 | 指定的磁盘未系统盘不能卸载 |
示例
请求示例
https://ecs.aliyuncs.com/?action=DetachDisk
&InstanceId=i-23jggx34b
&DiskId=d-23jbf2v5m
&<公共请求参数>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
时间： 2024-08-17 14:09:53