全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

ModifyDiskAttribute

更新时间:2017-09-13 12:55:27

描述

在该接口中设置的 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 磁盘是否随实例释放:
  • true 表示 Instance 释放时,这块磁盘随 Instance 一起释放
  • false 表示 Instance 释放时,这块磁盘保留不释放
在下列情况下,该参数设置成 false 时报错:
  • 当磁盘的 category 属性为 ephemeral
  • 当磁盘的 category 属性为 cloud 且 Portable 属性为 false
默认值:无,表示不改变当前的值
DeleteAutoSnapshot String 删除磁盘时,是否同时删除自动快照。
  • true 表示同时删除自动快照
  • false 表示保留自动快照
默认值:无,表示不改变当前的值
EnableAutoSnapshot String 磁盘是否执行自动快照策略(前提是用户整体的自动快照策略已经开启):
  • true 表示这块磁盘执行自动快照策略
  • false 表示这块磁盘不执行自动快照策略
默认值:无,表示不改变当前的值

返回参数

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

错误码

错误代码 描述 Http状态码 语义
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 格式不正确
NoAttributeToModify No attribute to be modified in this request. 400 没有任何属性被修改
DiskNotPortable The specified disk is not a portable disk. 403 磁盘不是可卸载的磁盘
QuotaExceed.Snapshot The maximum number of snapshots is exceeded. 403 快照额度超过限制
IncorrectDiskStatus The operation is not supported in this status. 403 磁盘状态不正确

示例

请求示例

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

返回示例

XML格式

  1. <ModifyDiskAttributeResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ModifyDiskAttributeResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录