调用AttachDisk为一台ECS实例挂载一块按量付费数据盘，或者挂载一块系统盘。实例和云盘必须在同一个可用区。

接口说明

调用该接口时，您需要注意：

  • 云盘的状态必须为待挂载（Available）。
  • 挂载数据盘时：
    • 目标ECS实例必须处于运行中（Running）或者已停止（Stopped）状态。
    • 如果是您单独购买的云盘，计费方式必须是按量付费。
    • 从ECS实例上卸载的系统盘作为数据盘挂载时，不限制计费方式。
  • 挂载系统盘时：
    • 目标ECS实例必须是卸载系统盘时的源实例。
    • 目标ECS实例必须处于已停止（Stopped）状态。
    • 您必须设置实例登录凭证。
  • 被安全控制的ECS实例的OperationLocks不能标记为"LockReason" : "security"。
  • 即使您在挂载云盘时，将DeleteWithInstance置为false，一旦ECS实例被安全控制，即OperationLocks中标记了"LockReason" : "security"，释放ECS实例时会忽略云盘的DeleteWithInstance属性而被同时释放。。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String 是 i-bp1ecr********5go2go

目标ECS实例的ID。
DiskId String 是 d-23jbf2v*************

待挂载的云盘ID。云盘（DiskId）和实例（InstanceId）必须在同一个可用区。

说明 支持挂载数据盘和系统盘，相关约束条件请参见上文接口说明章节。
Action String 否 AttachDisk

系统规定参数。取值：AttachDisk
Bootable Boolean 否 false

是否作为系统盘挂载。

默认值：false。

说明 设置为Bootable=true时，目标ECS实例必须处于无系统盘状态。
DeleteWithInstance Boolean 否 false

释放实例时，该云盘是否随实例一起释放。

  • true：释放。
  • false：不释放。云盘会转换成按量付费数据盘而被保留下来。

默认值：false。
Password String 否 EcsV587!

挂载系统盘时，设置实例的用户名密码，仅对administrator和root用户名生效，其他用户名不生效。长度为8至30个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是：


()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

其中，Windows实例不能以斜线号（/）为密码首字符。

说明 如果传入Password参数，建议您使用HTTPS协议发送请求，避免密码泄露。
KeyPairName String 否 Instancetest

挂载系统盘时，为Linux系统ECS实例绑定的SSH密钥对的名称。

  • Windows Server系统：不支持SSH密钥对。即使填写了该参数，只执行Password的配置。
  • Linux系统：密码登录方式会被初始化成禁止。
Device String 否 null

云盘设备名称。

说明 该参数即将被弃用，为提高兼容性，建议您尽量使用其他参数。

返回数据

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

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=AttachDisk
&DiskId=d-23jbf2v*************
&InstanceId=i-bp1ecr********5go2go
&DeleteWithInstance=false
&<公共请求参数>

正常返回示例

XML 格式 

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

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 是否正确。
400 InvalidDevice.Malformed The specified device is not valid. 指定的磁盘设备名不存在。
403 InstanceDiskLimitExceeded The amount of the disk on instance in question reach its limits. 指定实例已经达到可挂载磁盘的最大值。
403 InvalidDevice.InUse The specified device has been occupied. 指定的设备已经挂载了磁盘。
403 IncorrectDiskStatus The operation is not supported in this status. 当前的磁盘不支持此操作，请您确认磁盘处于正常使用状态，是否欠费。
403 DiskNotPortable The specified disk is not a portable disk. 指定的磁盘不是可卸载的磁盘，Portable为false的磁盘无法卸载。
403 InstanceLockedForSecurity The instance is locked due to security. 您的资源被安全锁定，拒绝操作。
403 ResourcesNotInSameZone The specified instance and disk are not in the same zone. 指定的实例和磁盘不在同一可用区。
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 包年包月实例已过期，请您续费后再进行操作。
403 DiskInArrears The specified operation is denied as your disk owing fee. 指定的磁盘已欠费。
400 IncorrectInstanceStatus The current status of the resource does not support this operation. 该资源目前的状态不支持此操作。
403 DiskError IncorrectDiskStatus. 指定的磁盘状态不合法。
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 DiskId.ValueNotSupported The specified parameter diskid is not supported. 指定的块存储类型不支持此操作。
403 DiskId.StatusNotSupported The specified disk status is not supported. 不支持指定的磁盘状态。
404 InvalidDisk.InUse The specified disk has been occupied. 指定的磁盘已占用。
404 DiskAttachedNumberExceeded The attaching times of the specified disk exceeded. 超过了该磁盘的附加时间。
403 UserNotInTheWhiteList The user is not in disk white list. 您暂时不能使用该磁盘服务。
400 InvalidRegionId.MalFormed The specified RegionId is not valid 指定的 RegionId 不合法。
400 InvalidOperation.InstanceTypeNotSupport The instance type of the specified instance does not support hot attach disk. 磁盘挂载的实例不支持磁盘热插拔操作。
400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category 由于磁盘种类限制，指定的磁盘不支持该操作。
400 InvalidOperation.InstanceTypeNotSupport The specified disk which has kms key should only attach to ioOptimized instance. 仅I/O优化实例支持KMS Key。
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. ECS未被授权访问您的KMS资源。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 发生未知错误。
400 InvalidParameter.AllEmpty %s 缺失必需参数。

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