すべてのプロダクト
Search
ドキュメントセンター

Server Load Balancer:ModifyCapacityReservation

最終更新日:May 29, 2026

ロードバランサーキャパシティーユニット (LCU) 予約を作成、または更新します。

操作説明

ModifyCapacityReservation は非同期オペレーションです。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。LCU 予約はすぐには更新されません。DescribeCapacityReservation API を呼び出して、LCU 予約のステータスを照会できます:

  • LCU 予約が Pending 状態の場合、作成中です。

  • LCU 予約が Provisioned 状態の場合、作成済みです。

  • LCU 予約が Rebalancing 状態の場合、ゾーン間でリバランスされています。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

LoadBalancerId

string

必須

Application Load Balancer (ALB) インスタンスの ID です。

alb-iv9gj3spak6fbj****

ResetCapacityReservation

boolean

任意

LCU 予約をキャンセルするかどうかを指定します。有効な値:

  • true:LCU 予約をキャンセルします。

  • false (デフォルト):LCU 予約をキャンセルしません。LCU 予約を作成または更新する際に、このパラメーターを指定する必要はありません。

false

MinimumLoadBalancerCapacity

object

任意

予約する LCU の最小値です。

CapacityUnits

integer

任意

1 時間あたりに予約する LCU の数です。

100

DryRun

boolean

任意

ドライランを実行するかどうかを指定します。有効な値:

  • true:チェックリクエストを送信しますが、リソースは予約されません。システムは、リクエストに必要なパラメーター、形式、およびサービスの制限をチェックします。チェックが失敗すると、エラーが返されます。チェックが成功すると、DryRunOperation エラーコードが返されます。

  • false (デフォルト):通常のリクエストを送信します。リクエストがチェックに成功すると、HTTP 2xx ステータスコードが返され、オペレーションが実行されます。

列挙値:

  • true :

    true

  • false :

    false

false

ClientToken

string

任意

リクエストのべき等性を保証するためのクライアントトークンです。クライアント側でトークンを生成し、リクエストごとに一意の値を使用してください。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

説明

このパラメーターが指定されていない場合、システムは RequestId を ClientToken として使用します。各 API リクエストの RequestId は異なります。

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

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマです。

RequestId

string

リクエスト ID です。

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

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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.
400 OperationDenied.DeploymentSetsNotSharedToAlb DeploymentSets are not shared to alb.
404 ResourceNotFound.LoadBalancer The specified resource of %s is not found.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。