阅读588 返回首页    go 魔兽


修改磁盘属性__磁盘相关接口_API 参考_云服务器 ECS-阿里云

描述

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

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:ModifyDiskAttribute
DiskId String 磁盘 ID
DiskName String 磁盘名称,不填则原值,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”.”,”_”或”-”,磁盘名称会展示在控制台。不能以 https:// 和 https:// 开头。
Description String 磁盘描述,不填则保持原值,默认值为空,[2, 256] 个字符,磁盘描述会展示在控制台。不能以 https:// 和 https:// 开头。
DeleteWithInstance String 磁盘是否随实例释放:
  • true 表示 Instance 释放时,这块磁盘随 Instance 一起释放
  • false 表示 Instance 释放时,这块磁盘保留不释放
在下列情况下,该参数设置成 false 时报错:
  • 当磁盘的 category 属性为 ephemeral
  • 当磁盘的 category 属性为 cloud 且 Portable 属性为 false
默认值:无,表示不改变当前的值
DeleteAutoSnapshot String 删除磁盘时,是否同时删除自动快照。
  • true 表示同时删除自动快照
  • false 表示保留自动快照
默认值:无,表示不改变当前的值
EnableAutoSnapshot String 磁盘是否执行自动快照策略(前提是用户整体的自动快照策略已经开启):
  • true 表示这块磁盘执行自动快照策略
  • false 表示这块磁盘不执行自动快照策略
默认值:无,表示不改变当前的值

返回参数

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

错误码

错误代码 描述 Http 状态码 语义
MissingParameter The input parameter "DiskId" that is mandatory for processing this request is not supplied. 400 DiskId 未指定
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁盘不存在
InvalidDiskName.Malformed The specified disk name is wrongly formed. 400 DiskName 格式不正确
InvalidDescription.Malformed The specified description is wrongly formed. 404 Description 格式不正确
InvalidParameter The specified parameter "DeleteWithInstance" is not valid. 400 指定的 DeleteWithInstance 参数不合法
NoAttributeToModify No attribute to be modified in this request. 400 没有任何属性被修改
DiskNotPortable It is not a portable disk. 403 磁盘不是可卸载的磁盘

示例

请求示例

https://ecs.aliyuncs.com/?action=ModifyDiskAttribute
&DiskId=d-23jbf2v5m
&DiskName=MyDiskName 
&<公共请求参数>

返回示例

XML格式

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

JSON格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

最后更新:2016-11-23 16:03:50

  上一篇:go 卸载磁盘__磁盘相关接口_API 参考_云服务器 ECS-阿里云
  下一篇:go 删除磁盘__磁盘相关接口_API 参考_云服务器 ECS-阿里云