调用ModifyDiskAttribute修改您的磁盘的属性或者明细。

接口说明

当您调用该接口时设置了 不随实例释放(DeleteWithInstance=false)属性,一旦磁盘挂载的 ECS 实例被 安全控制且 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态,释放实例时会忽略磁盘的 DeleteWithInstance 属性而被同时释放。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
DiskId String d-diskid1

待修改明细的磁盘 ID。

Action String ModifyDiskAttribute

系统规定参数。取值:ModifyDiskAttribute

DeleteAutoSnapshot Boolean false

删除磁盘时,是否同时删除其自动快照。默认值:无,无表示不改变当前的值。

DeleteWithInstance Boolean false

磁盘是否随实例释放。默认值:无,无表示不改变当前的值。

在下列两种情况下,将参数 DeleteWithInstance 设置成 false 时会报错。

  • 磁盘的种类(category)为本地盘(ephemeral)时。
  • 磁盘的种类(category)为普通云盘(cloud),且不可以卸载(Portable=false)时。
Description String FinanceDeptJoshua

磁盘描述。 长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。

DiskName String FinanceJoshua

磁盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

EnableAutoSnapshot Boolean true

如果您已经创建了自动快照策略,是否应用于该磁盘。默认值:无,无表示不改变当前的值。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

示例

请求示例


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

正常返回示例

XML 格式

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

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDiskId.NotFound The specified disk does not exist. 指定的磁盘不存在。请您检查磁盘 ID 是否正确。
400 InvalidDiskName.Malformed The specified disk name is wrongly formed. 磁盘名称格式不正确。长度为2-128个字符,以英文字母或中文开头,可包含数字,".","_"或"-"。 不能以 http:// 和 https:// 开头。
404 InvalidDescription.Malformed The specified description is wrongly formed. 指定的资源描述格式不合法。长度为2-256个字符,不能以 http:// 和 https:// 开头。
400 NoAttributeToModify No attribute to be modified in this request. 没有任何属性被修改。
403 QuotaExceed.Snapshot The snapshot quota exceeds. 快照额度超过限制,若要存储新快照,在不影响业务的情况下,请您删除已有的老快照。
403 DiskNotPortable The specified disk is not a portable disk. 指定的磁盘不是可卸载的磁盘,Portable为false的磁盘无法卸载。
403 IncorrectDiskStatus The operation is not supported in this status. 当前的磁盘不支持此操作,请您确认磁盘处于正常使用状态,是否欠费。
400 IncompleteParamter Some fields can not be null in this request. 请求中缺失参数。
403 UserNotInTheWhiteList The user is not in disk white list. 您暂时不能使用该磁盘服务。
400 InvalidRegionId.MalFormed The specified RegionId is not valid 指定的 RegionId 不合法。
404 InvalidInstanceId.NotFound Specified attached instance does not exist. 指定的实例不存在,请您检查实例ID是否正确。

访问错误中心查看更多错误码。