調(diào)用ModifyDiskAttribute修改一個(gè)或多個(gè)塊存儲(chǔ)的名稱、描述、是否隨實(shí)例釋放等屬性。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ecs:ModifyDiskAttribute | update | *Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId} |
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| DiskId | string | 否 | 待修改明細(xì)的磁盤 ID。 說明
DiskId和DiskIds.N兩個(gè)參數(shù)不能同時(shí)被調(diào)用，請(qǐng)您根據(jù)需求任選其一傳值。
| d-bp1famypsnar20bv**** |
| DiskName | string | 否 | 磁盤名稱。長度為 2~128 個(gè)字符，支持 Unicode 中 letter 分類下的字符（其中包括英文、中文和數(shù)字等）。可以包含半角冒號(hào)（:）、下劃線（_）、半角句號(hào)（.）或者短劃線（-）。 | MyDiskName |
| Description | string | 否 | 磁盤描述。 長度為 2~256 個(gè)英文或中文字符，不能以 | TestDescription |
| DeleteWithInstance | boolean | 否 | 磁盤是否隨實(shí)例釋放。默認(rèn)值：無，無表示不改變當(dāng)前的值。 開啟多重掛載特性的云盤，不支持設(shè)置該參數(shù)。 在下列兩種情況下，將參數(shù)
| false |
| DeleteAutoSnapshot | boolean | 否 | 刪除磁盤時(shí)，是否同時(shí)刪除其自動(dòng)快照。默認(rèn)值：無，無表示不改變當(dāng)前的值。 | false |
| EnableAutoSnapshot | boolean | 否 | 云盤是否啟用自動(dòng)快照策略功能。取值范圍：
默認(rèn)值：無，表示不改變當(dāng)前的值。 說明
創(chuàng)建后的云盤默認(rèn)啟用自動(dòng)快照策略功能。您只需要為云盤綁定自動(dòng)快照策略即可正常使用。
| true |
| RegionId | string | 是 | 地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| DiskIds | array | 否 | 待修改明細(xì)的多個(gè)磁盤 ID。N 的取值范圍為 0 ~ 100。 說明
DiskId和DiskIds.N兩個(gè)參數(shù)不能同時(shí)被調(diào)用，請(qǐng)您根據(jù)需求任選其一傳值。
| |
| string | 否 | 待修改明細(xì)的多個(gè)磁盤 ID。N 的取值范圍為 0 ~ 100。 說明
DiskId和DiskIds.N兩個(gè)參數(shù)不能同時(shí)被調(diào)用，請(qǐng)您根據(jù)需求任選其一傳值。
| d-bp1famypsnar20bv**** | |
| BurstingEnabled | boolean | 否 | 是否開啟 Burst（性能突發(fā)）。取值范圍：
| false |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidDiskName.Malformed | The specified disk name is wrongly formed. | 磁盤名稱格式不正確。長度為2-128個(gè)字符，以英文字母或中文開頭，可包含數(shù)字，點(diǎn)號(hào)（.），下劃線（_）或連字符（-）。 不能以http://和https://開頭。 |
| 400 | NoAttributeToModify | No attribute to be modified in this request. | 沒有任何屬性被修改。 |
| 400 | IncompleteParamter | Some fields can not be null in this request. | 請(qǐng)求中缺失參數(shù)。 |
| 400 | InvalidRegionId.MalFormed | The specified RegionId is not valid. | 指定的地域不存在，請(qǐng)檢查該參數(shù)是否正確。 |
| 400 | MissingParameter.DiskIdOrDiskIds | Specified parameter DiskId or DiskIds is missing. | - |
| 400 | ParameterConflict.DiskIdAndDiskIds | Specified parameter DiskId and DiskIds conflict, only one can be chosen. | - |
| 400 | BurstingEnabledForDiskCategoryUnsupported | The specified disk category does not support bursting enabled. | 指定的磁盤類型不支持開啟性能突發(fā)特性。 |
| 400 | BurstingEnabledForMultiAttachDiskUnsupported | The multi attach disk does not support bursting enabled. | 多重掛載磁盤不支持開啟性能突發(fā)特性。 |
| 400 | BurstingEnabledForModifyingDiskUnsupported | The modifying disk does not support bursting enabled. | 變配中的磁盤不允許修改burst特性。 |
| 403 | QuotaExceed.Snapshot | The snapshot quota exceeds. | 快照額度超過限制，若要存儲(chǔ)新快照，在不影響業(yè)務(wù)的情況下，請(qǐng)您刪除已有的老快照。 |
| 403 | DiskNotPortable | The specified disk is not a portable disk. | 指定的磁盤不是可卸載的磁盤，Portable 為 false 的磁盤無法卸載。 |
| 403 | IncorrectDiskStatus | The operation is not supported in this status. | 當(dāng)前的磁盤不支持此操作，請(qǐng)您確認(rèn)磁盤處于正常使用狀態(tài)，是否欠費(fèi)。 |
| 403 | UserNotInTheWhiteList | The user is not in disk white list. | 您不在磁盤白名單中，請(qǐng)加入白名單后重試。 |
| 403 | DeleteWithInstance.Conflict | The specified image is from the image market, you cannot set DeleteWithInstance attribute to false. | 指定的鏡像來自鏡像市場(chǎng)，不支持取消隨實(shí)例釋放。 |
| 403 | DeleteWithInstance.Conflict | Multi attach disk cannot be set to DeleteWithInstance attribute. | 開啟多重掛載特性的云盤不支持設(shè)置 DeleteWithInstance。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盤不存在。請(qǐng)您檢查磁盤 ID 是否正確。 |
| 404 | InvalidDescription.Malformed | The specified description is wrongly formed. | 指定的資源描述格式不合法。長度為 2-256 個(gè)字符，不能以 http:// 和 https:// 開頭。 |
| 404 | InvalidInstanceId.NotFound | Specified attached instance does not exist. | 指定的實(shí)例不存在，請(qǐng)您檢查實(shí)例 ID 是否正確。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-12-04 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-08-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |