調用ModifyDiskSpec變更一塊云盤類型，或者修改一塊ESSD云盤的性能級別。
接口說明
請確保在使用該接口前，您已充分了解云盤的計費方式和價格。
調用該接口完成以下操作時，您需要注意：
-
修改 ESSD 云盤性能級別：
-
包年包月 ESSD 云盤僅支持升級性能級別。
-
按量付費 ESSD 云盤支持升級和降低性能級別，但不支持降配到 PL0。
-
ESSD 云盤的狀態必須是使用中（In_Use）狀態或者待掛載（Available）狀態。
-
若 ESSD 云盤已掛載到 ECS 實例上，實例必須處于運行中（Running）狀態或者已停止（Stopped）狀態，ECS 實例不能處于過期或者賬號欠費狀態。
-
由于 ESSD 云盤性能級別受容量限制，如果您無法升級性能級別，可以擴容（ ResizeDisk ）后重新操作。更多信息，請參見 ESSD 云盤。
-
-
變更一塊云盤類型的注意事項，請參見變更云盤類型中的限制條件章節。
- 開啟多重掛載特性的云盤不支持云盤變配。
調用接口后，新的云盤類型立即生效，阿里云按照新的云盤類型及云盤性能級別單價計算消費賬單。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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. | 指定的實例ID未找到。 |
| 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 入參發生變更 | 查看變更詳情 |