修改您的磁碟的屬性或者明細。

描述

當您調用該介面時設定了 不隨執行個體釋放（DeleteWithInstance=false）屬性，一旦磁碟掛載的 ECS 執行個體被 安全控制且 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：釋放執行個體時，這塊磁碟隨執行個體一起釋放。
  • false：釋放執行個體時，保留磁碟，不隨執行個體一起釋放。
預設值：無，無表示不改變當前的值在下列兩種情況下，將參數 DeleteWithInstance 設定成 false 時會報錯。
  • 磁碟的種類（category）為本地碟（ephemeral）時。
  • 磁碟的種類（category）為普通雲端碟（cloud），且不可以卸載（Portable=false）時。
DeleteAutoSnapshot String 否 刪除磁碟時，是否同時刪除其自動快照。取值範圍：
  • true：刪除自動快照。
  • false：保留自動快照。
預設值：無，無表示不改變當前的值
EnableAutoSnapshot String 否 如果您已經建立了自動快照策略，是否應用於該磁碟。取值範圍：
  • true：磁碟執行自動快照策略。
  • false：磁碟不執行自動快照策略。
預設值：無，無表示不改變當前的值

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本 
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"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidDiskName.Malformed The specified disk name is wrongly formed. 400 指定的參數 DiskName 格式有誤。
NoAttributeToModify No attribute to be modified in this request. 400 您此次請求沒有修改任何屬性。
DiskNotPortable The specified disk is not a portable disk. 403 設定 DeleteWithInstance=false屬性時，磁碟的 Portable 屬性不能為 false。
IncorrectDiskStatus The operation is not supported in this status. 403 磁碟狀態不正確。磁碟狀態參閱 普通雲端碟狀態表。
InvalidDescription.Malformed The specified description is wrongly formed. 404 參數 Description 的格式有誤。
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁碟不存在。