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

:ModifyCapacityReservation

最終更新日:Nov 10, 2025

キャパシティ予約を作成および変更します。

操作説明

ModifyCapacityReservation は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。キャパシティ予約はすぐには変更されません。DescribeCapacityReservation 操作を呼び出して、キャパシティ予約のステータスをクエリできます。

  • キャパシティ予約が [保留中] 状態の場合、作成中です。

  • キャパシティ予約が [プロビジョニング済み] 状態の場合、作成済みです。

  • キャパシティ予約が [リバランス中] 状態の場合、ゾーン間でリバランスされています。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

LoadBalancerId

string

必須

Application Load Balancer インスタンスの ID。

alb-iv9gj3spak6fbj****

ResetCapacityReservation

boolean

任意

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

  • true: キャパシティ予約をキャンセルします。

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

false

MinimumLoadBalancerCapacity

object

任意

ロードバランサー用に予約する最小キャパシティ。

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.
404 ResourceNotFound.LoadBalancer The specified resource of %s is not found.

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

変更履歴

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