调用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:DetachDisk | update | *Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}*Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 待卸载的 ECS 实例 ID。 | i-bp67acfmxazb4p**** |
| DiskId | string | 是 | 待卸载的磁盘 ID。 | d-bp67acfmxazb4p**** |
| DeleteWithInstance | boolean | 否 | 卸载系统盘或数据盘时，设置自动释放属性。表示释放 ECS 实例时，是否同时释放该系统盘或数据盘。
默认值：true 您需要注意：
| false |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter | The input parameter is mandatory for processing this request is empty. | 参数不能为空。 |
| 400 | InvalidRegionId.MalFormed | The specified RegionId is not valid. | 指定的地域不存在，请检查该参数是否正确。 |
| 400 | InvalidOperation.InstanceTypeNotSupport | The instance type of the specified instance does not support hot detach disk. | 磁盘挂载的实例不支持磁盘热插拔操作。 |
| 400 | DisksDetachingOnEcsExceeded | The number of disks detaching on the instance exceeds the limit. | 实例上正在卸载的磁盘个数超过限制 |
| 403 | IncorrectDiskStatus | The current disk status does not support this operation. | 当前的磁盘不支持此操作，请您确认磁盘处于正常使用状态，是否欠费。 |
| 403 | DiskNotPortable | The specified disk is not a portable disk. | 指定的磁盘不是可卸载的磁盘，Portable 为 false 的磁盘无法卸载。 |
| 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 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 该资源目前的状态不支持此操作。 |
| 403 | UserNotInTheWhiteList | The user is not in disk white list. | 您不在磁盘白名单中，请加入白名单后重试。 |
| 403 | InvalidInstance.ImageCategory | The image category of the specified instance does not support detaching system disk. | 指定实例的镜像状态不支持卸载指定的系统盘。可能原因：创建实例时使用的镜像被删除。 |
| 403 | DeleteWithInstance.Conflict | Multi attach disk cannot be set to DeleteWithInstance attribute. | 开启多重挂载特性的云盘不支持设置 DeleteWithInstance。 |
| 403 | InvalidOperation.DiskCategoryUnsupported | The DetachDisk operation is not supported for elastic ephemeral disk. | 弹性临时盘不支持单独卸载 |
| 403 | InvalidParameter.DeleteWithInstance | The DeleteWithInstance for the elastic ephemeral disk must be set to true. | 弹性临时盘的 DeleteWithInstance 属性必须设置为 true。 |
| 403 | InvalidOperation.DiskDetachingFromThisEcs | The specified disk is detaching from this ecs. | 磁盘正在从当前实例上卸载。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例ID未找到。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盘不存在。请您检查磁盘 ID 是否正确。 |
| 404 | InvalidDisk.AlreadyDetached | The specified disk has been detached. | 指定的磁盘已分离。 |
| 404 | InvalidDiskId.OperationNotSupported | The operation is not supported due to base image not exist. | - |
| 500 | InternalError | The request processing has failed due to some unknown error. | 内部错误，请重试。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误，请重试。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-09-20 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-07-24 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-05-09 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-04-15 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-11-24 | OpenAPI 错误码发生变更 | 查看变更详情 |