为一台 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 指定的实例不存在。