修改磁盘属性
描述
在该接口中设置的 DeleteWithInstance 属性,在实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,释放实例时会忽略磁盘的 DeleteWithInstance 属性而被同时释放。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名,系统规定参数,取值:ModifyDiskAttribute |
| DiskId | String | 是 | 磁盘 ID |
| DiskName | String | 否 | 磁盘名称,不填则原值,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”.”,”_”或”-”,磁盘名称会展示在控制台。不能以 http:// 和 https:// 开头。 |
| Description | String | 否 | 磁盘描述,不填则保持原值,默认值为空,[2, 256] 个字符,磁盘描述会展示在控制台。不能以 http:// 和 https:// 开头。 |
| DeleteWithInstance | String | 否 | 磁盘是否随实例释放:
|
| DeleteAutoSnapshot | String | 否 | 删除磁盘时,是否同时删除自动快照。
|
| EnableAutoSnapshot | String | 否 | 磁盘是否执行自动快照策略(前提是用户整体的自动快照策略已经开启):
|
返回参数
全是公共返回参数,详见公共返回参数
错误码
| 错误代码 | 描述 | 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"
}