调用DetachDisk从一台实例上卸载一块按量付费磁盘。磁盘类型包括普通云盘、高效云盘和SSD云盘。

接口说明

当您使用该接口时,请注意:

  • 云盘的 Portable 属性必须为 True。
  • 云盘必须已经挂载到实例上,状态为 使用中(In_Use)。
  • 云盘所挂载的实例的状态必须为 运行中(Running)或者 已停止(Stopped)。
  • 云盘所挂载的实例被 安全控制 后,OperationLocks 中不能标记为 "LockReason" : "security" 的锁定状态。
  • 卸载磁盘后,其属性 DeleteWithInstance 会被置为 False,表示释放该实例时,会保留该云盘,不随实例一起释放。
  • 该接口是异步操作,调用接口成功后您需要等待片刻才能完成卸载,预计在 1 分钟左右。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
DiskId String d-diskid1

待卸载的云盘 ID。

InstanceId String i-instanceid1

待卸载的 ECS 实例 ID。

Action String DetachDisk

系统规定参数。取值:DetachDisk

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。无论调用接口成功与否,我们都会返回请求 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=DetachDisk
&DiskId=d-diskid1
&InstanceId=i-instanceid1
&<公共请求参数>

正常返回示例

XML 格式

<DetachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
404 InvalidDiskId.NotFound The specified disk does not exist. 指定的磁盘不存在。请您检查磁盘 ID 是否正确。
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. 该资源目前的状态不支持此操作。
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。如果多次尝试失败,请提交工单
400 InvalidParameter The input parameter is mandatory for processing this request is empty. 参数不能为空。
403 UserNotInTheWhiteList The user is not in disk white list. 您暂时不能使用该磁盘服务。
400 InvalidRegionId.MalFormed The specified RegionId is not valid 指定的 RegionId 不合法。
404 InvalidDisk.AlreadyDetached The specified disk has been detached. 指定的磁盘已分离。
400 InvalidOperation.InstanceTypeNotSupport The instance type of the specified instance does not support hot detach disk. 磁盘挂载的实例不支持磁盘热插拔操作。

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