全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

AttachDisk

更新时间:2017-09-13 12:57:56

描述

实例的状态必须为 running 或者 stopped,且实例的 OperationLocks 中没有标记 "LockReason" : "security" 的锁定状态,且不欠费。

在该接口中设置的 DeleteWithInstance 属性,在实例的 OperationLocks 中标记为"LockReason" : "security" 的锁定状态时,释放实例时会忽略磁盘的 DeleteWithInstance 属性而被同时释放。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:AttachDisk
InstanceId String 目标云服务器 ID
DiskId String 磁盘 ID,磁盘和 Instance 必须在同一个 Zone
DeleteWithInstance String 磁盘是否随实例释放:
  • true 表示 Instance 释放时,这块磁盘随 Instance 一起释放;
  • false 表示 Instance 释放时,这块磁盘保留不释放。
默认值:无,表示保留当前值不做修改。

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http状态码 语义
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例不存在
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁盘不存在
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. 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. 403 指定的磁盘已欠费
IncorrectInstanceStatus The current status of the resource does not support this operation. 400 指定的实例状态不正确
DiskError IncorrectDiskStatus. 403 不正常的磁盘状态
InvalidParameter The input parameter is mandatory for processing this request is empty. 400 请求缺少必填参数
DiskId.ValueNotSupported The specified parameter diskid is not supported. 403 指定的参数DiskId不支持
InvalidDiskId.NotFound The specified DiskId does not exist. 404 指定的磁盘不存在

示例

请求示例

  1. https://ecs.aliyuncs.com/?action=AttachDisk
  2. &InstanceId=i-23jggx34b
  3. &DiskId=d-23jbf2v5m
  4. &<公共请求参数>

返回示例

XML格式

  1. <AttachDiskResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </AttachDiskResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录