閱讀588 返回首頁    go 魔獸


修改磁盤屬性__磁盤相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

在該接口中設置的 DeleteWithInstance 屬性,在實例的 OperationLocks 中標記了 "LockReason" : "security" 的鎖定狀態時,釋放實例時會忽略磁盤的 DeleteWithInstance 屬性而被同時釋放。

請求參數

名稱 類型 是否必須 描述
Action String 操作接口名,係統規定參數,取值:ModifyDiskAttribute
DiskId String 磁盤 ID
DiskName String 磁盤名稱,不填則原值,默認值為空,[2, 128] 英文或中文字符,必須以大小字母或中文開頭,可包含數字,”.”,”_”或”-”,磁盤名稱會展示在控製台。不能以 https:// 和 https:// 開頭。
Description String 磁盤描述,不填則保持原值,默認值為空,[2, 256] 個字符,磁盤描述會展示在控製台。不能以 https:// 和 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格式

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

JSON格式

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

最後更新:2016-11-23 16:03:50

  上一篇:go 卸載磁盤__磁盤相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇:go 刪除磁盤__磁盤相關接口_API 參考_雲服務器 ECS-阿裏雲