割り当てと上限

このページでは、API Gateway の割り当て上限について説明します。

API、API 構成、ゲートウェイの上限

API ゲートウェイでは、API、API 構成、ゲートウェイに次の上限が適用されます。

API - 合計 50
API 構成 - 1 つの API あたり 100
ゲートウェイ - 1 つのリージョンあたり 50

同じ API の最初の API 構成の作成が完了する前に 2 番目の API 構成を作成しようとすると、一方または両方の構成が、後でゲートウェイで使用できなくなることがあります。

リクエスト頻度の上限

デフォルトでは、1 つのサービスプロデューサープロジェクトに対して 100 秒あたり 1,000 万の割り当てユニットというレート制限が設定されています。割り当てユニットは、services.check への呼び出しごとと、services.report から報告されたオペレーションごとに 1 つずつ消費されます。

ペイロードサイズの上限

デプロイされたゲートウェイを経由するトラフィックの最大ペイロードサイズには、具体的に以下の上限が適用されます。

上限	量
リクエストサイズ	32 MB
レスポンスサイズ	32 MB
gRPC コード変換レスポンスサイズ	1 MB
gRPC コード変換リクエストサイズ	1 MB

ストリーミングはサポートされていません。

ヘッダーサイズの上限

デプロイされたゲートウェイを経由するトラフィックの最大ヘッダーサイズには、具体的に以下の上限が適用されます。

上限	金額
リクエストヘッダーのサイズ	60 KB

API Gateway によって呼び出されるバックエンドサービスには、より低い上限が設定されている場合があります。

割り当てを増やす方法

Cloud Quotas の調整リクエストは審査の対象となります。割り当て調整リクエストの審査が必要な場合は、リクエストの受領確認メールが届きます。ご不明な点がある場合は、そのメールに返信してください。リクエストが審査されると、リクエストが承認されたかどうかを通知するメールが届きます。割り当ての調整は、 Google Cloud コンソール、Cloud Quotas API、または Google Cloud CLI を使用してリクエストできます。次の手順では、 Google Cloud コンソールを使用するか、Cloud Quotas API に REST リクエストを送信して、新しい割り当て値をリクエストする方法について説明します。

コンソール

割り当ての調整をリクエストする手順は次のとおりです。

Google Cloud コンソールで、[IAM と管理] > [割り当てとシステム上限] ページに移動します。
[割り当てとシステム上限] に移動
プロジェクトを選択するよう求められたら、調整するプロジェクトを選択します。
調整する割り当てを見つけて、[割り当ての変更] ダイアログを開きます。
- 表にない割り当て:
  - [フィルタ] 検索ボックスで割り当てを検索します。使用量や調整後の値がない割り当てはテーブルに表示されないため、リージョンまたはゾーンを指定しないでください（該当する場合）。
  - テーブルで割り当てのエントリを探します。これは、デフォルトのエントリでも、リージョンやゾーンに関係なく履歴のあるエントリでもかまいません。
  - エントリの行で、 [その他の操作] > [追加のリージョン/ゾーンを構成] をクリックします。
  - 調整するリージョンまたはゾーンを選択します。[編集] をクリックします。
- 他のすべての割り当て:
  - [フィルタ] 検索ボックスで割り当てを検索します。
  - エントリの行で、割り当てのチェックボックスをオンにします。
  - [編集] をクリックします。
[割り当ての変更] ダイアログが表示されます。
[新しい値] フィールドの上に [割り当ての増加を申し込む] リンクが表示されていて、画面に表示されている数値を超える割り当て値に引き上げる場合は、そのリンクをクリックします。フォームに記入して送信し、残りの手順はスキップします。それ以外の場合は、このガイドに沿って操作を続けます。
[新しい値] フィールドに、必要な割り当ての引き上げ値を入力します。[リクエストの説明] フィールドが表示されている場合は、説明を入力します。[完了] をクリックします。
- [このリクエストでオーバーライドが削除されることを理解しました] というメッセージが表示されたチェックボックスが表示されている場合は、割り当て値がデフォルト値より低く設定されています。割り当て値をデフォルト値またはデフォルト値以上に調整すると、オーバーライドが削除されます。続行するには、チェックボックスをオンにします。詳細については、割り当てのオーバーライドをご覧ください。
[次へ] ボタンが表示されたら、[次へ] をクリックし、次の画面で連絡先情報を入力します。
[リクエストを送信] をクリックします。

コンソールから調整をリクエストできない場合は、Cloud カスタマーケアに引き上げをリクエストしてください。

割り当ての増加プロセスの仕組みについては、割り当ての調整についてをご覧ください。

割り当て調整リクエストをバッチ処理する

割り当ての調整をまとめてリクエストするには、追加する個々の割り当てのチェックボックスをオンにします。ただし、バッチリクエストにより、 Google Cloud によるリクエストの審査に時間がかかることがあります。

審査時間を短縮するには、割り当て調整リクエストをプロダクトとエリア別にグループ化します。たとえば、ネットワーキングと Compute Engine VM の割り当ての調整をリクエストする場合は、ネットワーキングの割り当てリクエストと Compute Engine VM の割り当てリクエストをそれぞれ作成します。

REST

Cloud Quotas API から割り当ての調整をリクエストするには、次のコードサンプルを使用します。編集可能なプレースホルダに値を入力します。プレースホルダフィールドについては、コード例の後の説明をご覧ください。

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

次のように置き換えます。

PROJECT_NUMBER: Google Cloud プロジェクトの番号。プロジェクト番号は、 Google Cloud コンソールの [ようこそ] ページで確認できます。また、次の gcloud CLI コマンドを実行して確認することもできます。
```
PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"
```
QUOTA_PREFERENCE_ID: 更新する割り当て設定の ID。
QUOTA_ID: 更新する割り当ての ID。
SERVICE_ID: 調整する割り当てが属する Google Cloud の ID。通常、これは SERVICE_NAME.googleapis.com という形式になります。たとえば、Compute Engine サービス名は compute.googleapis.com です。
DIMENSION_1: 調整するディメンションのタイプ（region や zone など）。複数のディメンションを含めることができます。各ディメンションは、値（VALUE_1 など）の後にカンマを付けて区切ります。割り当てのすべてのディメンションを調整するには、この行を省略します。
VALUE_1: 前のディメンションの値。たとえば、前のディメンションが region の場合は、us-central1 などのリージョンを入力します。
JUSTIFICATION: このリクエストの理由。
EMAIL: 連絡先として使用できるメールアドレス。 Google Cloud が、追加の割り当てを付与する前に追加情報が必要な場合に使用されます。

リクエストの例

次の例は、Compute Engine 割り当て PUS-PER-GPU-FAMILY-per-project-region の割り当て値の増加リクエストです。リージョン us-central1 にある GPU ファミリー NVIDIA_H100 のマシンの割り当て値として 100 をリクエストします。

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}