從一台執行個體上卸載一塊隨用隨付磁碟。磁碟類型包括普通雲端碟、高效雲端碟和SSD雲端碟。

描述

當您使用該介面時,請注意:

  • 雲端碟的 Portable 屬性必須為 True
  • 雲端碟必須已經掛載到執行個體上,狀態為 使用中In_Use)。
  • 雲端碟所掛載的執行個體的狀態必須為 運行中Running)或者 已停止Stopped)。
  • 雲端碟所掛載的執行個體被 安全控制 後,OperationLocks 中不能標記為 "LockReason" : "security" 的鎖定狀態。
  • 卸載磁碟後,其屬性 DeleteWithInstance 會被置為 False,表示釋放該執行個體時,會保留該雲端碟,不隨執行個體一起釋放。

  • 該介面是非同步作業,調用介面成功後您需要等待片刻才能完成卸載,預計在 1 分鐘左右。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DetachDisk
InstanceId String 待卸載的 ECS 執行個體 ID。
DiskId String 待卸載的雲端碟 ID。

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DetachDisk
&InstanceId=i-23jggx34b
&DiskId=d-23jbf2v5m
&<公共請求參數>
返回樣本

XML 格式

<DetachDiskResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>
JSON 格式
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidParameter The input parameter is mandatory for processing this request is empty. 400 請求缺少必填參數。
DependencyViolation The specified disk has not been attached on the specified instance. 403 指定的磁碟並沒有掛載在指定的執行個體上。
DiskNotPortable The specified disk is not a portable disk. 403 指定磁碟不是可卸載的雲端碟。
DiskTypeViolation The specified disk is a system disk and cannot support the operation. 403 您不能卸載執行個體的系統盤。
IncorrectDiskStatus The current disk status does not support this operation. 403 磁碟必須已經掛載到執行個體上,狀態為 使用中In_Use)。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 磁碟所掛載的執行個體的狀態必須為 運行中Running)或者 已停止Stopped)。
InstanceLockedForSecurity The instance is locked due to security. 403 指定的執行個體被 安全控制
InvalidDiskId.Released The specified disk has been released. 403 指定的磁碟已經釋放。
InvalidDiskId.NotFound The specified DiskId does not exist. 404 指定的磁碟不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的執行個體不存在。