割り当ての操作

Google Cloud では、プロジェクトオーナーのリソース使用量に対して一定の割り当てが定められており、プロジェクトで使用できる特定の Google Cloud リソースの量に厳密な上限が設けられています。割り当てによるリソース使用量の上限には、次の 2 種類があります。

1 日あたりの API リクエストの数など、頻度に基づく割り当て上限。このタイプの割り当ては、指定された時間（1 分や 1 日など）が経過するとリセットされます。
プロジェクトで使用されている仮想マシンやロードバランサの数など、数量に基づく割り当て上限。このような割り当ては、時間が経過してもリセットされません。リソースを使用する必要がなくなったら、GKE クラスタを削除するなどして、明示的に解放する必要があります。

割り当てが適用されるのには、さまざまな理由があります。たとえば、割り当てを適用することで予期しない使用量の急増を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当てはリソース管理にも役立ちます。たとえば、アプリケーションの開発とテストを行う際に、Google から指定された割り当て内でサービスの使用量に独自の上限を設定できます。それぞれの割り当て上限は、API に対する 1 日あたりのリクエスト数から、アプリケーションで使用されるロードバランサの数まで、カウント可能な特定のリソースについて表されます。

同じサービスでも、すべてのプロジェクトに同じ割り当てが適用されるわけではありません。たとえば、無料トライアルアカウントを使用してプラットフォームを試用する場合は、割り当て量が非常に限られていることがあります。一部のサービスについては、プロジェクトで課金を有効にした後にのみ、割り当てを増やすことができます。Google Cloud の利用期間が長くなると、それに応じて割り当てが増えることがあります。必要に応じて割り当ての増加をリクエストし、Cloud Monitoring でモニタリングとアラートを設定して割り当て使用量の異常な動作や割り当て上限への接近を警告することもできます。

割り当て上限は、サービス所有者、プロジェクト所有者、割り当て管理者によって適用される割り当てオーバーライドの影響を受ける場合があります。割り当て上限の計算方法について詳しくは、サービスの割り当てモデルをご覧ください。

このページでは、既存の割り当て上限を確認して変更する方法、割り当ての増加をリクエストする方法、割り当て使用量のモニタリング方法など、プロジェクトの割り当てを扱う方法について説明します。その他の API 使用状況の指標を見る方法については、API 使用状況のモニタリングをご覧ください。

割り当ての確認

Google Cloud Console で現在の割り当ての上限を確認するには、主に次の 2 つの方法があります。

[割り当て] ページを使用すると、すべてのプロジェクトの割り当ての使用状況と上限のリストを確認できます。
コンソールを使用すると、リソース使用量の推移など、特定の API の割り当て情報を確認できます。

割り当て上限には、Service Usage API を使ってプログラムによってアクセスすることもできます。

さらに、一部のサービスでは、割り当てやリソース使用量に関する情報にコマンドラインからアクセスすることもできます。たとえば、Compute Engine では、gcloud compute を使用して割り当て情報にアクセスできます。

割り当て使用量をモニタリングする方法と割り当てのアラートを設定する方法については、割り当て指標のモニタリングのセクションをご覧ください。

プロジェクトのすべての割り当てを表示する

プロジェクト内のすべてのリソースの割り当て（割り当ての使用状況と上限）を表示する手順は次のとおりです。

Cloud Console で [IAM と管理] の [割り当て] ページに移動します。
プロジェクトリストからプロジェクトを選択するか、新しいプロジェクトを作成します。選択したプロジェクトの [割り当て] ページが開き、各サービスで使用できる割り当ての種類ごとに 1 行の項目を含むリストが表示されます。
結果を並べ替え、またはフィルタリングすることで、必要な情報を探すことができます。
- ページの上部にあるフィルタ（[割り当てのタイプ]、[サービス]、[指標]、[場所]）を使用してリストを絞り込みます。
- デフォルトの並び順では、過去 7 日間のピーク使用量に基づいて最も多く使用されている割り当てが先頭に表示されます。これは超過するおそれがある上限を確認するのに便利です。[7 日間のピーク使用量] の矢印を選択すると、使用量の少ない順に並べ替えることができます。

このリストには、特定の割り当ての [現在の使用量] も表示されます。数量に基づく割り当ての場合、この欄に表示されるのは、現在使用しているリソースの量です。1 日あたりの頻度に基づく割り当ての場合は、現在の日付におけるその時点までの使用量です。1 分または 100 秒あたりの頻度に基づく割り当ての場合は、過去 24 時間の平均使用量が表示されます。

特定のサービスの割り当てとそれらの意味については、それぞれのドキュメントに詳しく記載されています。たとえば、Compute Engine の割り当てについては、リソースの割り当てをご覧ください。

API 固有の割り当て

特定の API の詳細な割り当て情報（一定期間の使用量など）を確認するには、Cloud Console でその API の割り当てページにアクセスします。API に応じて、これらの上限は、1 日あたりのリクエスト数、1 分あたりのリクエスト数、ユーザーごとの 1 分あたりのリクエスト数などになります。一部の API では、プロジェクトで課金を有効にするまで、上限は非常に低く設定されています。

特定の API の現在の上限を表示する手順は次のとおりです。

Cloud Console で [API とサービス] の [ダッシュボード] ページに移動します。
プロジェクトリストからプロジェクトを選択するか、新しいプロジェクトを作成します。
対象の API の名前をクリックします。
[割り当て] をクリックします。選択した API の割り当ての名前とそれに対応する上限が [割り当て] ページに表示されます。デフォルトでは、これらの上限は Google から課されたものです。これより低い上限を指定する方法については、使用量の上限を設定するをご覧ください。Google から上限が課されていない割り当てには、[無制限] と表示されます。

すべての割り当てが API 固有の割り当てページに表示されるわけではありません。たとえば、Compute Engine API に対するリクエストには API 固有の割り当てページがありますが、Compute Engine のコンピューティングリソース使用量（数量に基づく割り当て）はこのページには表示されません。また、複数のロケーションでサービスを使用している場合、API 固有の割り当てページには、リージョンまたはゾーンの割り当ての上限と使用状況は表示されません。プロジェクトのすべての割り当てのリストを確認する方法については、プロジェクトの [割り当て] ページをご覧ください。このリストをロケーションでフィルタリングすることもできます。

Cloud Console を使用した割り当ての管理

リソースの使用状況に応じて、プロジェクトの割り当てを増減して上限を調整できます。このセクションでは、指定されている割り当て上限を変更する方法について説明します。

割り当ての増加をリクエストする

割り当て上限があるほとんどの課金対象サービスについて、割り当ての変更をリクエストできます。手順は次のとおりです。

[割り当て] ページで、編集する割り当てのチェックボックスを 1 つ以上選択してから、[割り当てを編集] をクリックします。チェックボックスをクリックするには、プロジェクトで課金を有効にする必要があります。
右側の [割り当ての編集] パネルで、[名前]、[メール]、[電話番号] などの詳細をフォームに入力し、[次へ] をクリックします。
[割り当ての編集] パネルで、サービスを選択してビューを展開し、そのサービスの割り当てを編集して、任意の上限に設定します。[完了] をクリックします。
選択した各サービスで同じ手順を繰り返して割り当てを編集します。
- アラートアイコン（error）が表示されているサービスは、まだ編集されていないか、入力されていないフィールドがあります。
- 編集する割り当てを追加するには、左側のリストから割り当てを選択します。
- 削除アイコン（delete）をクリックすると、[割り当てを編集] パネルからサービスを削除できます。
割り当ての編集が完了したら、[リクエストを送信] をクリックします。

Google Cloud の割り当てリクエストは通常、2 営業日以内に迅速に処理されます。リクエストの確認メールが Google Cloud サポートから届きます。ご不明な点がある場合は、そのメールに返信してください。割り当ての増加量が大きい場合は、承認に時間がかかることがあります。

使用量の上限を設定する

割り当ての上限を独自に設定することで、特定のリソースの使用量を制限できます。たとえば、無料枠を超えた使用量について課金されるのを防ぐために、1 日あたりのリクエスト数の上限を設定できます。割り当ての上限を設定する最も簡単な方法は、API 固有の割り当てページで上限を編集することです。

Cloud Console で、使用量の上限を設定する API の割り当てページに移動します。
割り当てを変更する行の編集アイコン（edit）をクリックし、Google から指定された上限以下の任意の合計割り当て量を入力します。
[保存] をクリックして、変更を保存します。

このページに表示されていない割り当ての上限を設定する場合、または指定されている最大量よりも高い上限を設定する場合は、上限を編集する必要があります。割り当ての増加をリクエストするで説明した手順に従ってください。

Service Usage API を使用した割り当ての管理

Service Usage API を使用することで、Service Usage によって管理されている Google Cloud APIs とサービスについて、その割り当て使用量の上限の設定や現在の割り当て上限の確認を行うことができます。Service Usage の詳細については、以下をご覧ください。

概要については、Service Usage とはをご覧ください。
API リファレンスについては、API とリファレンスをご覧ください。
使用ガイドについては、入門ガイドをご覧ください。

Service Usage API を使用して割り当ての増加をリクエストすることはできません。これを行う場合は、Cloud Console を使用する必要があります。

割り当て指標のモニタリングとアラートの設定

Google Cloud では、Cloud Console で基本的な割り当て情報を確認するほかに、Cloud Monitoring API および UI と Metrics Explorer に表示される割り当て指標を使用して、割り当ての使用状況、上限、エラーを詳細にモニタリングすることもできます。これらの指標を使用してカスタムダッシュボードを作成し、割り当て使用状況の変化をモニタリングできます。また、割り当ての上限に近づいたときにアラートを受け取ることも可能です。

Cloud Monitoring はさまざまな指標をサポートしています。これらの指標とフィルタや集計を組み合わせることで、割り当ての使用状況を詳しく分析できます。たとえば、数量に基づく割り当て使用量のカウント指標と、Cloud TPU 名を指定した quota_metric フィルタを組み合わせることができます。

Metrics Explorer を使用してモニタリング対象リソースの指標を表示する方法は次のとおりです。

Google Cloud Console で [モニタリング] を選択するか、次のボタンを使用します。
[モニタリング] に移動
[Monitoring] のナビゲーションパネルで、 [Metrics Explorer] をクリックします。
[Metric] タブが選択されていることを確認します。
[Find resource type and metric] のボックスをクリックして、リソースと指標をメニューから選択するか、リソースと指標の名前を入力します。次の情報を使用して、このテキストボックスのフィールドに入力します。
1. [Resource] で、[Consumer Quota] を選択または入力します。
2. [Metric] で [Allocation quota usage] を選択または入力して、数量に基づく割り当てをモニタリングします。[Rate quota usage] を選択または入力して、頻度に基づく割り当てをモニタリングします。
[Filter]、[Group By]、[Aggregation] の各メニューを使用して、データの表示方法を変更します。たとえば、リソースラベルや指標ラベルごとにグループ化できます。詳細については、指標の選択 - 追加構成をご覧ください。

目的の割り当て使用量の情報が見つかったら、Cloud Monitoring を使用してカスタムダッシュボードとアラートを作成し、継続的なモニタリングによって堅牢なアプリケーションを維持できます。同様に、割り当て上限または超過エラーを表示するには、まずリソースタイプとして [Consumer Quota] を選択し、次に [Quota limit] または [Quota exceeded error] を選択します。以下を行う方法については、それぞれのページをご覧ください。

割り当て指標の詳細なリファレンスについては、Cloud Monitoring のドキュメントをご覧ください。

割り当てのエラー

サービスの使用中にプロジェクトで特定の割り当てを超えた場合は、エラーが返されます。

一般に、HTTP / REST を使用してサービスにアクセスしている場合は HTTP 429 エラーコードが返され、gRPC を使用している場合は ResourceExhausted が返されます。このエラーがどのように表示されるかは、サービスによって異なります。

Cloud Monitoring を使用している場合は、エラーに関連付けられている割り当ての特定に使用して、割り当てエラーの発生時に表示されるカスタムアラートを作成できます。詳細については、割り当て指標のモニタリングをご覧ください。