為一台 ECS 執行個體掛載一塊資料盤。

描述

調用該介面時，您需要注意：

  • 待掛載的 ECS 執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。

  • 掛載資料盤時，雲端碟的狀態必須為 待掛載（Available）。

  • 被 安全控制 的 ECS 執行個體的 OperationLocks 中標記了 "LockReason" : "security" 時，不允許調用該介面。

  • 即使您在掛載雲端碟時，將 DeleteWithInstance 置為 false，一旦 ECS 執行個體被安全控制，且 OperationLocks中標記了 "LockReason" : "security"，釋放 ECS 執行個體時會忽略雲端碟的 DeleteWithInstance 屬性而被同時釋放。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：AttachDisk
InstanceId String 是 待掛載的 ECS 執行個體 ID。
DiskId String 是 待掛載的雲端碟 ID。雲端碟（DiskId）和執行個體（InstanceId）必須在同一個可用性區域。
DeleteWithInstance String 否 待掛載的雲端碟是否隨執行個體釋放。取值範圍：
  • true：釋放執行個體時，該雲端碟隨執行個體一起釋放。
  • false：釋放執行個體時，保留該雲端碟，不隨執行個體一起釋放。
預設值：無

返回參數

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

樣本

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

XML 格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
IncorrectInstanceStatus The current status of the resource does not supportthis operation. 400 待掛載的 ECS 執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。
InvalidParameter The input parameter is mandatory for processing thisrequest is empty. 400 缺少必填參數。
DiskError IncorrectDiskStatus. 403 雲端碟的狀態必須為 待掛載（Available）。
DiskId.ValueNotSupported The specified parameter diskid is not supported. 403 指定的參數 DiskId 不支援。
DiskInArrears The specified operation is denied as your disk owingfee. 403 指定的雲端碟已欠費。
DiskNotPortable The specified disk is not a portable disk. 403 指定雲端碟不是可卸載的雲端碟。
IncorrectDiskStatus The operation is not supported in this status. 403 掛載資料盤時，雲端碟的狀態必須為 待掛載（Available）。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 指定的執行個體已欠費。
InstanceLockedForSecurity The instance is locked due to security. 403 指定的執行個體被安全鎖定。
InvalidDevice.InUse The specified device has been occupied. 403 指定的雲端碟已經被掛載到其他執行個體上。
ResourcesNotInSameZone The specified instance and disk are not in the samezone. 403 指定雲端碟和執行個體必須在同一個可用性區域。
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的雲端碟不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的執行個體不存在。