全部產品
Search
文件中心

Server Load Balancer:ModifyCapacityReservation - 修改資源預留

更新時間:Nov 10, 2025

建立和修改資源預留。

介面說明

ModifyCapacityReservation 介面屬於非同步介面,即系統返回一個請求 ID,但該資源預留尚未完成,系統背景預留任務仍在進行。您可以調用 DescribeCapacityReservation 查詢資源預留的狀態:

  • 當資源預留處於 Pending 狀態時,表示資源預留進行中中。

  • 當資源預留處於 Provisioned 狀態時,表示資源預留已經完成。

  • 當資源預留處於 Rebalancing 狀態時,表示資源預留正在在可用性區域間重新分配。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

LoadBalancerId

string

應用型Server Load Balancer執行個體 ID。

alb-iv9gj3spak6fbj****

ResetCapacityReservation

boolean

是否取消資源預留。取值:

  • true:取消資源預留。

  • false(預設值):不取消資源預留。建立、修改資源預留時可不填寫此屬性。

false

MinimumLoadBalancerCapacity

object

預留的最小負載平衡器容量。

CapacityUnits

integer

每小時預留 LCU 數量。

100

DryRun

boolean

是否只預檢此次請求,取值:

  • true:發送檢查請求,不會預留資源。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼DryRunOperation

  • false(預設值):發送正常請求,通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。

false

ClientToken

string

保證請求的等冪性。從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元,且不能超過 64 個字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

593B0448-D13E-4C56-AC0D-FDF0F******

樣本

正常返回樣本

JSON格式

{
  "RequestId": "593B0448-D13E-4C56-AC0D-FDF0F******"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 OperationDenied.ListenerNotFound The operation is not allowed because of ListenerNotFound.
400 OperationDenied.CapacityReservationNotSupport Resource reservation is not supported.
400 OperationDenied.CapacityUnitsBelowMinimum The operation is not allowed because of CapacityUnitsBelowMinimum.
400 OperationDenied.CapacityDecreaseRequestLimitExceeded The operation is not allowed because of CapacityDecreaseRequestLimitExceeded.
400 OperationDenied.PriorRequestNotComplete The operation is not allowed because of PriorRequestNotComplete.
400 OperationDenied.DeploymentSetExists The operation is not allowed because of OperationDenied.DeploymentSetExists.
400 OperationDenied.DeploymentSetIsEmpty The operation is not allowed because of OperationDenied.DeploymentSetIsEmpty.
400 OperationDenied.DeploymentSetsConflicts The operation is not allowed because of OperationDenied.DeploymentSetsConflicts.
400 OperationDenied.DeploymentSetsNotSupport The operation is not allowed because of OperationDenied.DeploymentSetsNotSupport.
400 OperationDenied.DeploymentSetsStrategyNotMatch The operation is not allowed because of DeploymentSetsStrategyNotMatch.
400 QuotaExceeded.ReservationMaxLcuPerLb The quota of %s is exceeded, usage %s/%s.
400 QuotaExceeded.ReservationMaxLcuPerRegion The quota of %s is exceeded, usage %s/%s.
400 QuotaExceeded.DeploymentSetsNum The quota of %s is exceeded, usage %s/%s.
404 ResourceNotFound.LoadBalancer The specified resource of %s is not found. 資源%s不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情