修改磁盘属性
描述
在该接口中设置的 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 | 否 | 磁盘是否随实例释放：
在下列情况下，该参数设置成 false 时报错：
默认值：无，表示不改变当前的值 |
| 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"
}
时间： 2024-12-30 21:50:13