修改磁盘属性
描述
在该接口中设置的 DeleteWithInstance 属性,在实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,释放实例时会忽略磁盘的 DeleteWithInstance 属性而被同时释放。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
操作接口名,系统规定参数,取值:ModifyDiskAttribute
DiskId
String
是
磁盘 ID
DiskName
String
否
磁盘名称,不填则原值,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”.”,”_”或”-”,磁盘名称会展示在控制台。不能以 // 和 https:// 开头。
Description
String
否
磁盘描述,不填则保持原值,默认值为空,[2, 256] 个字符,磁盘描述会展示在控制台。不能以 // 和 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格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
所属专题: