修改一個Block Storage裝置的名稱、描述、是否隨執行個體釋放、是否隨磁碟刪除其自動快照、是否啟用自動快照策略、是否開啟效能突發功能等。
介面說明
您可以調用 DiskId 參數修改一個Block Storage裝置的名稱、描述、是否隨執行個體釋放等屬性
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
地區 ID。可調用 DescribeRegions 擷取。 |
cn-hangzhou |
| DiskId |
string |
是 |
待修改屬性的磁碟 ID。 |
rcd-wz9c8isqly8637zw**** |
| DiskName |
string |
否 |
磁碟名稱。長度為 2~128 個字元，支援 Unicode 中 letter 分類下的字元（其中包括英文、中文和數字等）。可以包含半形冒號（:）、底線（_）、半形句號（.）或者短劃線（-）。 |
testDisk |
| Description |
string |
否 |
磁碟描述。 長度為 2~256 個英文或中文字元，不能以 http://和 https://開頭。 |
test |
| DeleteWithInstance |
boolean |
否 |
磁碟是否隨執行個體釋放。預設值：無，無表示不改變當前的值。 開啟多重掛載特性的雲端硬碟，不支援設定該參數。 在下列兩種情況下，將參數 DeleteWithInstance 設定成 false 時會報錯。 磁碟的種類（category）為本地碟（ephemeral）時。 磁碟的種類（category）為普通雲端硬碟（cloud），且不可以卸載（Portable=false）時。 警告 如果您設定了不隨執行個體釋放（DeleteWithInstance=false），一旦磁碟掛載的 ECS 執行個體被安全鎖定且 OperationLocks 中標記了"LockReason" : "security"的鎖定狀態，釋放執行個體時會忽略磁碟的 DeleteWithInstance 屬性而被同時釋放。 |
false |
| BurstingEnabled |
boolean |
否 |
針對支援 Burst（效能突發）的磁碟是否開啟此功能，取值範圍： true：是。 false：否。 說明 對於不支援 Burst 功能的磁碟，傳入任意值將會報錯。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
樣本
正常返回樣本
JSON格式
{
"RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidRegionId.MalFormed | The specified parameter RegionId is not valid. | 指定的 RegionId 不合法。 |
| 400 | InvalidDiskName.Malformed | The specified disk name is wrongly formed. | 磁碟名稱格式不正確。長度為2-128個字元，以英文字母或中文開頭，可包含數字，點號（.），底線（_）或連字號（-）。 不能以http://和https://開頭。 |
| 400 | NoAttributeToModify | No attribute to be modified in this request. | 沒有任何屬性被修改。 |
| 400 | IncompleteParamter | Some fields can not be null in this request. | 請求中缺失參數。 |
| 400 | MissingParameter.DiskIdOrDiskIds | Specified parameter DiskId or DiskIds is missing. | 缺少指定參數DiskId或DiskIds。 |
| 400 | BurstingEnabledForDiskCategoryUnsupported | The specified disk category does not support bursting enabled. | 指定的磁碟類型不支援開啟效能突發特性。 |
| 400 | BurstingEnabledForMultiAttachDiskUnsupported | The multi attach disk does not support bursting enabled. | 多重掛載磁碟不支援開啟效能突發特性。 |
| 400 | BurstingEnabledForModifyingDiskUnsupported | The modifying disk does not support bursting enabled. | 變更配置中的磁碟不允許修改burst特性。 |
| 400 | InvalidBurstingEnabled.DiskSizeTooSmall | The disk size must be greater than 3 GiB to enable burst. | 磁碟大小超過3GiB時才能開啟效能突發。 |
| 403 | QuotaExceed.Snapshot | The snapshot quota exceeds. | 快照額度超過限制，若要儲存新快照，在不影響業務的情況下，請您刪除已有的老快照。 |
| 403 | DiskNotPortable | The specified disk is not a portable disk. | 指定的磁碟不是可卸載的磁碟，Portable 為 false 的磁碟無法卸載。 |
| 403 | IncorrectDiskStatus | The operation is not supported in this status. | 當前的磁碟不支援此操作，請您確認磁碟處於正常使用狀態，是否欠費。 |
| 403 | UserNotInTheWhiteList | The user is not in disk white list. | 您不在磁碟白名單中，請加入白名單後重試。 |
| 403 | DeleteWithInstance.Conflict | Multi attach disk cannot be set to DeleteWithInstance attribute. | 開啟多重掛載特性的雲端硬碟不支援設定 DeleteWithInstance。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁碟不存在。請您檢查磁碟 ID 是否正確。 |
| 404 | InvalidDescription.Malformed | The specified description is wrongly formed. | 指定的資源描述格式不合法。長度為 2-256 個字元，不能以 http:// 和 https:// 開頭。 |
| 404 | InvalidInstanceId.NotFound | Specified attached instance does not exist. | 指定的執行個體不存在，請您檢查執行個體 ID 是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。