割り当て

このドキュメントでは、App Engine の割り当てとシステムの上限について説明します。

• 割り当ては、使用できるカウント可能な共有リソースの量を指定します。割り当ては、App Engine などの Google Cloud サービスによって定義されます。
• システムの上限は固定値で、変更できません。

Google Cloud では、割り当てを使用して公平性を確保し、リソースの使用量と可用性の急増を抑えます。割り当ては、Google Cloud プロジェクトで使用できる Google Cloud リソースの量を制限します。割り当ては、ハードウェア、ソフトウェア、ネットワーク コンポーネントなど、さまざまなリソースタイプに適用されます。たとえば、割り当てによって、サービスへの API 呼び出しの数、プロジェクトで同時に使用されるロードバランサの数、作成可能なプロジェクトの数を制限できます。割り当てを適用することで、サービスの過負荷を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当ては、自組織で使用している Google Cloud リソースの管理にも役立ちます。

Cloud Quotas システムは次のことを行います。

• Google Cloud のプロダクトとサービスの消費量をモニタリングする
• これらのリソースの消費量を制限する
• 割り当て値の変更をリクエストする方法を提供する

ほとんどの場合、割り当ての許容量を超えるリソースを消費しようとすると、システムによってリソースへのアクセスがブロックされ、実行しようとしているタスクは失敗します。

割り当ては通常、Google Cloud プロジェクト レベルで適用されます。あるプロジェクトでリソースを使用しても、別のプロジェクトで使用可能な割り当てに影響することはありません。Google Cloud プロジェクト内では、すべてのアプリケーションと IP アドレスで割り当てが共有されます。

App Engine リソースにはシステムの上限もあります。システムの上限は変更できません。

App Engine アプリケーションは、一定の割り当てに達するまでリソースを利用できます。アプリケーションの日々のリソース消費状況は、Google Cloud コンソールの [割り当ての詳細] ページで確認できます。

割り当てのタイプ

次の割り当てのタイプが App Engine アプリケーションに適用されます。

• 無料の割り当て: アプリケーションには、無料で利用できるリソースの量が設定されます。無料の割り当ての詳細については、このページのリソース セクションをご覧ください。アプリケーションが無料の割り当てを超えると、そのリソースの追加使用に対して料金が請求されます。

  無料の割り当てが提供されるのは、App Engine スタンダード環境の場合のみです。

• 1 日の割り当ては App Engine システムの整合性を維持し、1 つのアプリがリソースを過剰に消費して他のアプリの実行に支障をきたすことがないように設定されます。これらの上限を超えると、エラーが発生します。1 日の割り当ては、太平洋時間の午前 0 時にリセットされます。
• 分単位の割り当ては、アプリケーションが短時間ですべてのリソースを消費しないように制限します。また、別のアプリケーションが特定のリソースを占有しないように制限します。アプリケーションが短時間でリソースを消費し、分単位の割り当てを超えると、Google Cloud コンソールの [割り当て] ページで、該当する割り当ての横に「制限中」と表示されます。1 分間の最大値に達しているリソースに対するリクエストは拒否されます。

プロジェクト オーナーと課金管理者は、プロジェクトの課金を有効にできます。

割り当てを超過した場合に起こることと、割り当て超過状態の対処法については、リソースが不足した場合をご覧ください。

ヒント: 1 分あたりの最大割り当ては、トラフィック量が多いレベルに合わせて調整され、ニュースでサイトが取り上げられてトラフィックが急増しても対処できるレベルになっています。特定の割り当てがこの条件を満たしていないと思われる場合には、Issue Tracker でフィードバックをお送りください。フィードバックを送信することは、割り当て増加をリクエストすることにはなりませんが、一般的なユースケースにおいて低すぎる可能性がある割り当てを Google が把握するために役立ちます。

非常に高いトラフィック レベルが予想される場合や、なんらかの理由でアプリが特に高い割り当てを必要とする（重要なプロダクトのリリース、大規模な負荷テストなど）場合、サポート パッケージにサインアップすることをおすすめします。

リソースの補充

App Engine は、システムのリソース割り当てに対するアプリケーションの利用状況を記録しています。 App Engine は、毎日午前 0 時にすべてのリソース測定をリセットします。ただし、保存データの場合には、その時点でのデータストア ストレージの使用量を表します。

毎日の割り当ては、太平洋標準時の深夜 0 時に補充されます。分単位の割り当ては 60 秒ごとにリセットされます。

リソースがすべて消費された場合

アプリケーションが割り当てられたリソースをすべて消費すると、割り当てが補充されるまで、そのリソースは使用できなくなります。つまり、割り当てが補充されるまでアプリケーションが動作しない場合があります。

リクエストの開始に必要なリソースの場合、リソースがすべて消費されると、App Engine では、デフォルトで、リクエスト ハンドラを呼び出さずに、HTTP 403 または 503 エラーコードを返します。この動作は、インスタンス時間リソースに適用されます。

ヒント: アプリケーションが割り当てを超えたときに、カスタム エラーページを表示するようにアプリケーションを構成することもできます。詳しくは、Python（2.7、3）、Java、Go、PHP（5.5、7）、Node.js をご覧ください。

他のリソースの場合、リソースがすべて消費されたときにアプリケーションがリソースを利用しようとすると、例外が発生します。この例外はアプリケーションで処理できます。たとえば、わかりやすいエラー メッセージをユーザーに表示できます。Python API の場合、この例外は apiproxy_errors.OverQuotaError です。Java の API の場合、この例外は com.google.apphosting.api.ApiProxy.OverQuotaException です。Go API の場合は、appengine.IsOverQuota 関数で、エラーが割り当て不足による API 呼び出しの失敗を示しているかどうかを報告します。

次の例は OverQuotaError を取得する方法を表しています。メール関連の割り当てを超過した場合に、SendMessage() メソッドでこの例外が発生します。

try:
    mail.SendMessage(to='test@example.com', from='admin@example.com',
            subject='Test Email', body='Testing')
except apiproxy_errors.OverQuotaError, message:
    # Log the error. logging.error(message)
    # Display an informative message to the user.
    self.response.out.write('The email could not be sent. '
            'Please try again later.')

アプリがデフォルトの上限を超えている場合、スループット上限の引き上げをリクエストするには、Cloud カスタマーケアにお問い合わせください。より多くのメール割り当てが必要な場合は、SendGrid を使用してメールを送信します。

リソース

アプリケーションでは、割り当てに従って次のリソースを使用できます。請求対象の上限が適用されるリソースには、「（請求対象）」と明記されています。リソースの量は 24 時間の割り当て量を表します。

追加リソースの料金については、料金ページをご覧ください。

サービス、バージョン、インスタンス

デプロイできるサービスやバージョンの最大数は、アプリが有料か無料かに応じて次のとおりです。フレキシブル環境とスタンダード環境の両方で、サービスとバージョンは同じ上限を共有します。たとえば、同じアプリに標準バージョンとフレキシブル バージョンがある場合、それらのバージョンは同じ上限に向かってカウントされます。

基本スケーリングまたは手動スケーリングを適用する各サービスのインスタンス数には以下の上限があります。

また、プロジェクトとリージョンごとに実行できる標準バージョン全体にわたるインスタンス数にも上限があります。適用される上限と、そのサービスのインスタンスが割り当て使用量に与える影響は、サービスのインスタンス クラスによって決まります。たとえば、1 つの F4 インスタンスは、4 つの正規化されたフロントエンド インスタンスとしてカウントされます。

インスタンスのカウントによる割り当て使用量は、IAM の割り当てページで確認できます。

注: 上限の引き上げをリクエストするには、こちらのページに記載されている手順を行ってください。

デフォルトの Cloud Storage バケット

以下に示すように、デフォルトの Cloud Storage バケットには、毎日の使用量に対する無料の割り当て枠があります。デフォルトで無料のこのバケットは、Google Cloud Console でプロジェクトの App Engine の設定ページから作成できます。

以下の割り当ては、デフォルトのバケットを使用する場合に適用されます。 割り当てについては、Cloud Storage マルチリージョン バケットの料金をご覧ください。

Blobstore

以下の割り当ては、Blobstore を使用する場合に適用されます。

Blobstore の保存データ

Blobstore に保存されているデータの合計量。有料と無料の両方に適用されます。

コードと静的データの保存

静的データの上限

Go 以外の言語では、1 つの静的データファイルのサイズを 32 MB 以下にする必要があります。 Go での上限は 64 MB です。

ストレージの合計

ストレージの割り当ては、アプリのすべてのバージョンのコードと静的データを合計した量に対して適用されます。保存しているコードと静的データの合計サイズはメイン ダッシュボードの表に表示されます。保存しているコードのサイズは [バージョン] 画面、静的データのサイズは [バックエンド] 画面にそれぞれ表示されます。1 GB を超えるコードと静的データを保存すると、毎月 1 GB あたり $ 0.026 が課金されます。

Datastore モードの Firestore（Datastore）

保存データ（請求対象）の割り当ては、データストアおよび Blobstore 内のアプリケーションのために保存されたすべてのデータが対象になります。Google Cloud Console で [割り当ての詳細] 画面の [データストア] セクションに表示される他の割り当ては、データストア サービスの割り当てを表します。

保存データ（課金対象）

データストア エンティティに保存されているデータと、それに対応するインデックスと Blobstore の合計量。

データストアに保存されているデータの場合、大きなオーバーヘッドが発生する可能性があります。オーバーヘッドの量は、関連するプロパティの数や種類によって異なります。オーバーヘッドには組み込みインデックスとカスタム インデックスで使用される容量も含まれます。データストアに保存される個々のエンティティには、以下のメタデータが必要となります。

• エンティティ キー。種類、ID またはキー名、エンティティの祖先のキーを含みます。
• 各プロパティの名前と値。データストアにはスキーマが存在しないため、どのエンティティに対しても各プロパティの名前と値を一緒に保存しておく必要があります。
• このエンティティを参照するすべての組み込みインデックス行とカスタム インデックス行。個々の行には、エンティティの種類、任意の数のプロパティ値（インデックスの定義によって異なる）、エンティティ キーが含まれます。

インデックス数

アプリケーションに存在するデータストア インデックスの数。アプリケーションの構成に表示されていなくても、削除されていない以前のインデックスも含まれます。制限について詳しくは、Datastore の制限のページをご覧ください。

書き込みオペレーション

データストア書き込みオペレーションの合計数。

読み取りオペレーション

データストア読み取りオペレーションの合計数。

小規模なオペレーション

データストアで実行された小規模オペレーションの合計数。小規模オペレーションには、データストア ID を割り当てるための呼び出しや、キーのみのクエリなどが含まれます。

注: データストア管理者とデータストア閲覧者によるデータストア オペレーションはアプリケーションの割り当てに対してカウントされます。

デプロイ

App Engine アプリケーションごとに 1 日あたり 10,000 回までデプロイできます。

デプロイ時に、Cloud Build によってコンテナ イメージがビルドされ、Artifact Registry に保存されます。イメージに使用される保存容量の合計が無料枠を超えると料金が発生します。

ファイル

次の割り当てが、アプリのデプロイ ファイルの合計数に適用されます。

インスタンス時間

インスタンスの使用時間には、インスタンスの稼働時間に応じて所定の料金が請求されます。

「F」と「B」のインスタンス クラスには、個別の無料の割り当てがあります（「フロントエンド」と「バックエンド」インスタンス クラスとも呼ばれます）。App Engine サービスを使用する場合、適用される割り当てはサービスのインスタンス クラスによって決まります。

インスタンス時間の累積はインスタンスが起動した時点で開始されます。終了時点は、インスタンスに指定したスケーリングのタイプに応じて以下のように異なります。

• 基本または自動スケーリング: 課金はインスタンスが最後のリクエストを処理してから 15 分後に終了します。
• 手動スケーリング: 課金はインスタンスがシャットダウンしてから 15 分後に終了します。

App Engine によって作成されるアイドル状態のインスタンスの数が、Google Cloud コンソールの [パフォーマンス設定] タブで指定した最大数を超えると、超過分のインスタンスはインスタンス時間に累積されません。

Logs

ログデータが取得されると、Logs API が課金されます。

ログの取得上限は、アプリケーションのリクエストログとアプリケーション ログのデータが対象となります。App Engine アプリのロギングは、Google Cloud Observability によって行われます。料金と上限の詳細については、Google Cloud Observability の料金をご覧ください。

メール

Mail API の使用量は、IAM の割り当てページで確認できます。

注: IAM 割り当てページでアプリケーションの割り当て使用量を表示するには、プロジェクトで App Engine レポート サービスが有効になっていることを確認します。サービスを有効にできない場合は、権限と constraints/serviceuser.services 組織ポリシーの制約を確認してください。

注: 上限の引き上げをリクエストするには、こちらのページに記載されている手順を行ってください。

App Engine ではメッセージ単位でメールの料金を請求します。1 人に送信した 1 件のメールを 1 通のメッセージとします。たとえば、同じメールを 10 人に送信した場合、10 通のメッセージとして計算します。

管理者以外に送信されたメッセージ

アプリケーションからアプリケーション管理者以外に送信されたメッセージの総数。

管理者に送信されたメッセージ

アプリケーションから管理者に送信したメッセージの総数。各管理者メールのサイズの上限は 16 KB です。この中にはヘッダー、添付ファイル、本文が含まれます。

メッセージの本文として送信されたデータ

メールの本文として送信したデータの量。

送信済み添付ファイル

メールと一緒に送信された添付ファイルの総数。

添付ファイルとして送信したデータ

メールの添付ファイルとして送信したデータの量。

Mail API に追加できる承認送信者の上限は 50 件です。

毎日のメール割り当てを超えるメールの送信

アプリによるメール送信のための割り当てを引き上げる必要がある場合、サードパーティのメール プロバイダ（SendGrid、Mailjet、Mailgun など）を使用できます。

リクエスト

送信帯域幅（請求対象）

リクエストに応答してアプリケーションが送信したデータの量。

次の操作が含まれます。

• アプリケーション サーバー、静的ファイル サーバー、Blobstore がリクエストに応答して送信したデータ。保護されたリクエストも保護されていないリクエストも含まれます。
• メールで送信したデータ。
• URL 取得サービスが送信した HTTP 送信リクエストに含まれるデータ。

受信帯域幅

アプリケーションがリクエストから受信したデータの量。HTTP 受信リクエストのサイズは 32 MB 以下です。

次の操作が含まれます。

• 保護されたリクエストまたは保護されていないリクエストからアプリケーションが受信したデータ
• Blobstore へのアップロード
• URL 取得サービスが HTTP リクエストに応答して受信したデータ

保護された送信帯域幅

安全な接続経由でアプリケーションがリクエストに応答して送信したデータの量。

保護された受信帯域幅

保護された接続経由でアプリケーションがリクエストから受信したデータの量。

検索

以下の表に、Search API の無料割り当てを示します。検索呼び出しの各タイプの詳細については、Java、Python、Go のドキュメントをご覧ください。

料金表に従って Search API リソースの料金が請求されます。

アプリケーション コンソールでは、割り当てに API リクエストの実際の数が表示されます。 1 回の呼び出しで複数のドキュメントのインデックスを作成した場合、ドキュメントの数だけ呼び出し回数が増えます。

サービスの信頼性を維持するため、Search API には次の制限が設定されています。

• アプリまたはインデックス内での実行できるクエリの回数は 1 分あたり合計で 100 分まで。
• 1 分間に追加または削除できるドキュメントは 15,000 件まで。

注: これらの上限は分単位で適用されますが、Google Cloud コンソールには各上限についての日単位の合計数が表示されます。シルバー、ゴールド、プラチナ サポートをご契約の方は、サポート担当者に連絡して、スループットの上限を引き上げることができます。

タスクキュー

タスクが実行されると、関連するリクエストがアプリケーションのリクエスト割り当てにカウントされます。

これらの上限はすべてのタスクキューに適用されます。

注: タスクを実行または削除すると、タスクが使用したストレージが解放されます。ストレージの割り当ては一定の間隔で更新されるため、回収された容量がすぐに反映されない場合があります。詳しくは、Python、Java、Go、PHP のドキュメントをご覧ください。

以下の上限は、タスクキューのタイプに応じて適用されます。

cron

以下の割り当ては、cron ジョブに適用されます。

cron ジョブ

cron ジョブの数。

URL 取得

UrlFetch API の呼び出し回数

アプリケーションが URL 取得サービスにアクセスして HTTP または HTTPS リクエストを実行した回数。

UrlFetch の送信データ

リクエストで URL 取得サービスに送信されたデータの量。

UrlFetch の受信データ

レスポンスで URL 取得サービスから受信したデータの量。受信帯域幅の上限が適用されます。