修改磁盤屬性

　　描述

　　在該接口中設置的 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"