阿里云如何使用修改磁盤屬性接口
來源:技術(shù)員聯(lián)盟┆發(fā)布時間:2017-12-07 00:04┆點擊:
修改磁盤屬性
描述
在該接口中設(shè)置的 DeleteWithInstance 屬性,在實例的 OperationLocks 中標(biāo)記了 "LockReason" : "security" 的鎖定狀態(tài)時,釋放實例時會忽略磁盤的 DeleteWithInstance 屬性而被同時釋放。
請求參數(shù)
名稱
類型
是否必須
描述
Action
String
是
操作接口名,系統(tǒng)規(guī)定參數(shù),取值:ModifyDiskAttribute
DiskId
String
是
磁盤 ID
DiskName
String
否
磁盤名稱,不填則原值,默認(rèn)值為空,[2, 128] 英文或中文字符,必須以大小字母或中文開頭,可包含數(shù)字,”.”,”_”或”-”,磁盤名稱會展示在控制臺。不能以 和 https:// 開頭。
Description
String
否
磁盤描述,不填則保持原值,默認(rèn)值為空,[2, 256] 個字符,磁盤描述會展示在控制臺。不能以 和 https:// 開頭。
DeleteWithInstance
String
否
磁盤是否隨實例釋放:
true 表示 Instance 釋放時,這塊磁盤隨 Instance 一起釋放
false 表示 Instance 釋放時,這塊磁盤保留不釋放
在下列情況下,該參數(shù)設(shè)置成 false 時報錯:
當(dāng)磁盤的 category 屬性為 ephemeral
當(dāng)磁盤的 category 屬性為 cloud 且 Portable 屬性為 false
默認(rèn)值:無,表示不改變當(dāng)前的值
DeleteAutoSnapshot
String
否
刪除磁盤時,是否同時刪除自動快照。
true 表示同時刪除自動快照
false 表示保留自動快照
默認(rèn)值:無,表示不改變當(dāng)前的值
EnableAutoSnapshot
String
否
磁盤是否執(zhí)行自動快照策略(前提是用戶整體的自動快照策略已經(jīng)開啟):
true 表示這塊磁盤執(zhí)行自動快照策略
false 表示這塊磁盤不執(zhí)行自動快照策略
默認(rèn)值:無,表示不改變當(dāng)前的值
返回參數(shù)
全是公共返回參數(shù),詳見公共返回參數(shù)
錯誤碼
錯誤代碼
描述
Http 狀態(tài)碼
語義
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 參數(shù)不合法
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
&<公共請求參數(shù)>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"