變更一塊云盤類型,或者修改一塊ESSD云盤的性能級別。ESSD同城冗余云盤(公測)、普通云盤、彈性臨時盤和本地盤均不支持變更云盤類型。
接口說明
請確保在使用該接口前,您已充分了解云盤的計費方式和價格。
為了減少變配操作對您業務帶來的影響,請您在業務低峰期進行變配。
調用該接口時,您需要注意:
-
修改 ESSD 云盤性能級別:
-
包年包月 ESSD 云盤僅支持升級性能級別。
-
按量付費 ESSD 云盤支持升級和降低性能級別,但不支持降配到 PL0。
-
ESSD 云盤的狀態必須是使用中(In_Use)狀態或者待掛載(Available)狀態。
-
若 ESSD 云盤已掛載到 ECS 實例上,實例必須處于運行中(Running)狀態或者已停止(Stopped)狀態,不能處于過期或者賬號欠費狀態。
-
由于 ESSD 云盤性能級別受容量限制,如果您無法升級性能級別,可以擴容( ResizeDisk )后重新操作。更多信息,請參見 ESSD 云盤。
-
-
變更一塊云盤類型的注意事項,請參見變更云盤類型。
-
不同類型的云盤支持變配的情況,請參見云盤支持變配情況。
- 開啟多重掛載特性的云盤不支持云盤變配。
云盤變配后,計費變化情況如下:
-
按量付費云盤:按照新的云盤類型計費。
-
包年包月云盤:在計費周期內,會根據新舊配置的價格差和剩余天數(從次日 0 點到有效期結束)來計算應補繳的費用。
關于云盤的計費信息,請參見塊存儲計費。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ecs:ModifyDiskSpec | update | *Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DiskId | string | 是 | 云盤的 ID。 | d-bp131n0q38u3a4zi**** |
PerformanceLevel | string | 否 | 修改一塊 ESSD 云盤的性能級別。取值范圍:
默認值:PL1。 | PL2 |
DiskCategory | string | 否 | 變更一塊云盤的類型。取值范圍:
默認值:空,表示不變配云盤。 說明
| cloud_essd |
DryRun | boolean | 否 | 是否只預檢此次請求。取值范圍:
默認值:false。 | false |
ProvisionedIops | long | 否 | 是否修改 ESSD AutoPL 云盤預配置讀寫 IOPS。取值范圍:0~min{50000, 1000*容量-基準性能}。 基準性能=min{1,800+50*容量, 50,000} 說明
當 DiskCategory 取值為 cloud_auto 時才支持設置該參數。更多信息,請參見ESSD AutoPL 云盤和修改 ESSD AutoPL 云盤預配置信息。
| 50000 |
PerformanceControlOptions | object | 否 | 磁盤性能控制參數集合 | |
IOPS | integer | 否 | 2000 | |
Throughput | integer | 否 | 200 | |
Recover | string | 否 | 重置云盤性能,僅支持專屬存儲集群云盤。 設置該參數后,PerformanceControlOptions.IOPS 和 PerformanceControlOptions.Throughput 參數不生效。 目前僅支持設置為 All(重置云盤 IOPS 和吞吐量到初始值)。 | All |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TaskId": "t-bp67acfmxazb4p****",
"OrderId": "20413515388****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidPerformanceLevel.Malformed | The specified parameter PerformanceLevel is not valid. | 指定的參數 PerformanceLevel 無效。 |
400 | InvalidDiskCategory.ValueNotSupported | The specified parameter "DiskCategory" is not valid. | - |
400 | InvalidPerformanceLevelParam.Mismatch | The specified parameter PerformanceLevel should be null when DiskCategory is not cloud_essd. | - |
400 | OperationDenied.DiskInDedicatedBlockStorageCluster | The disk in dedicated block storage cluster is not allowed to do this operation. | - |
400 | IncorrectDiskStatus.ReplicationStatusNotFound | Disk replication status not found. | - |
400 | IncorrectDiskStatus.InReplication | Disk already in replication. | - |
400 | ProvisionedIopsForDiskCategoryUnsupported | The specified disk category does not support provisioned iops. | 指定的磁盤類型不支持預配置IOPS。 |
400 | InvalidProvisionedIops.LimitExceed | The provisioned iops exceeds the limit. | - |
400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | 指定磁盤類型的已用容量超出可用區配額限制,您可以前往配額中心查詢和申請提升磁盤容量配額。 |
400 | MalformedParameter.PerformanceControlOptions | Parameter invalid, %s. | 參數不合法 |
400 | InvalidPerformanceControlOptions.ModifyOperationUnsupported | The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS. | 磁盤性能控制參數與磁盤類型、磁盤性能等級、預配置IOPS參數沖突。 |
400 | NoPermission.Price | The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true. | - |
400 | NoPermission.Refund | The operation requires refund permission. Please apply for permission from your main account. | - |
400 | InvalidOperation.InstanceRenewWithDowngradeInPlan | The operation is denied due to the specified instance has renew with downgrade record in plan. | 存在未生效的續費降配訂單。訂單生效前不允許此操作。 |
400 | InvalidParameter.Conflict | %s | 您輸入的參數無效,請檢查參數之間是否沖突。%s為變量,將根據調用API的實際情況動態返回錯誤信息。 |
403 | DiskInArrears | The specified operation is denied as your disk owing fee. | 指定的磁盤已欠費。 |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 實例已過期或者欠費,請您續費或者結清后再進行操作。 |
403 | IncorrectDiskStatus | The current disk status does not support this operation. | 當前的磁盤不支持此操作,請您確認磁盤處于正常使用狀態,是否欠費。 |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | 指定的磁盤正在創建快照。 |
403 | OperationDenied | The type of the disk does not support the operation. | 此磁盤種類不支持指定的操作。 |
403 | InvalidPerformanceLevel.TooLow | Specified new performance level is lower than the original performance level. | - |
403 | OperationDenied.PerformanceLevelNotMatch | The specified PerformanceLevel and disk size do not match. | 指定的性能等級與磁盤大小不匹配。 |
403 | UserNotInTheWhiteList | The user is not in modify disk category white list. | - |
403 | InvalidRegion.NotSupport | The specified region does not support modify disk category. | - |
403 | InvalidDiskCategory.ValueNotSupported | The current disk category of the resource does not support this operation. | - |
403 | Downgrade.NotSupported | Downgrade operation for prepay resource is not supported. | - |
403 | InvalidInstanceType.NotSupportDiskCategory | The instanceType of the specified instance does not support this disk category. | 指定的實例規格(InstanceType)不支持當前實例的云盤類別。請嘗試更換其它實例規格。關于實例規格支持的云盤類型,請參見實例規格族文檔。 |
403 | ModifyingDiskCategoryLimitExceed | The amount of modifying disk category exceeds the limit. | 當前地域正在變配的磁盤個數超過上限 |
403 | DiskInCoolingPeriod | There is a cooling period after the disk is successfully modified. | 云盤處于變配周期限制中,不可再次發起變配 |
403 | DiskHasFlashSnapshot | The specified disk with flash snapshots do not support modify disk category. | - |
403 | NoChangeInDiskCategoryAndPerformanceLevel | There is no change between the parameters transmitted and the current. | 您所傳的磁盤種類和性能等級與當前磁盤一致 |
403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | 庫存不足。 |
403 | InvalidOperation.MultiAttachDisk | Multi attach disk does not support this operation. | 開啟多重掛載特性的云盤不支持該操作。 |
403 | OperationDenied.DiskExpansionUnfinished | The instance has not been restarted after a previous disk expansion. | - |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 指定的云盤類型不支持當前操作。 |
403 | InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster | The specified disk not in dedicated storage cluster, can not modify performance control options. | 非專屬存儲集群磁盤不支持修改磁盤性能控制參數。 |
403 | InvalidStatus.DiskUnderPerformanceControl | The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported.. | 磁盤處于性能控制狀態,無法進行磁盤類型、性能等級變更。 |
403 | InvalidStatus.DiskNotReady | This specified disk is not ready, status needs to be either In_use or Available. | 指定磁盤的狀態必須是In_use或Available。 |
404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的磁盤不存在。請您檢查磁盤 ID 是否正確。 |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
404 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內部錯誤,請重試。 |
404 | InvalidDiskCategory.ValueUnauthorized | The specified DiskCategory is not authorized. | 該磁盤種類未經授權。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-08-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-07-31 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-01-29 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-10-18 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-05-16 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-04-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |