割り当ての操作

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 行の項目を含むリストが表示されます。別のプロジェクトの割り当てを表示する場合は、プロジェクトリストからプロジェクトを選択するか、新しいプロジェクトを作成します。
結果を並べ替え、またはフィルタリングすることで、必要な情報を探すことができます。
- ページの上部にあるフィルタ（[サービス]、[上限名]、[割り当てステータス]、[サービス ID]、[指標]）を使用してリストを調整します。
- デフォルトでは、リストは [割り当てステータス]（各ステータスのサービスをアルファベット順に表示）でソートされ、最も使用されている割り当てが最初に表示ます。これは超過するおそれがある上限を確認するのに便利です。[割り当てステータス] の矢印を選択すると、使用量が最も少ないものが最初に表示されるように切り替えることができます。リストを [サービス名] や [上限名] で並べ替えて、アルファベット順または逆アルファベット順に表示することもできます。
リストからアイテムを選択して、割り当てパネルに現在の上限と使用状況を表示します。
- 上限値は、この割り当ての現在の上限です。デフォルトでは、これらの上限は Google によって課せられているものです。さらに低い上限を指定する方法については、使用量の上限を設定するをご覧ください。Google から上限が課されていない割り当てには、[無制限] と表示されます。これより低い使用量の値はそれぞれ、この上限にどれだけ近づいているかを示します。
- 現在の使用量の値は、割り当てタイプによって意味が少し異なります。数量に基づく割り当ての場合、現在の使用量は、現在使用しているリソースの量です。1 日あたりの頻度に基づく割り当ての場合は、現在の日付におけるその時点までの使用量です。1 分または 100 秒あたりの頻度に基づく割り当ての場合は、過去 24 時間の平均使用量です。
- 7 日間のピーク値は、過去 7 日間のピーク使用量を示します。
リージョンまたはゾーンの割り当てについては、割り当てパネルには各リージョンまたはゾーンの値が表示されます。

リージョンまたはゾーンの割り当てについては、関連するリストアイテムの [すべての割り当て] をクリックして、リージョンまたはゾーンごとの使用率を示す概要ページを表示できます。以下で説明するように、リスト内のサービス名をクリックして、より詳細な API 固有の割り当て情報を表示することもできます。

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

API 固有の割り当て

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

特定の API の現在の上限を表示するには:

上記のプロジェクトのすべての割り当てを表示するで説明されているように、Cloud Console の [割り当て] ページに移動し、目的の API のサービス名をクリックします。

または

Cloud Console で [API とサービス] の [ダッシュボード] ページに移動します。
プロジェクトリストからプロジェクトを選択するか、新しいプロジェクトを作成します。
対象の API の名前をクリックします。
[割り当て] をクリックします。

選択した API の割り当ての名前が [割り当て] ページに表示されます。各割り当てを展開すると、詳細な使用状況の推移と現在の上限を確認できます。デフォルトでは、これらの上限は Google によって課せられているものです。さらに低い上限を指定する方法については、使用量の上限を設定するをご覧ください。Google から上限が課されていない割り当てには、[無制限] と表示されます。

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

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

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

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

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

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

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

使用量の上限を設定する

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

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

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

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

Service Usage API を使用することで、Service Usage によって管理されている Google Cloud の API とサービスについて、その割り当て使用量の上限の設定や現在の割り当て上限の確認を行うことができます。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] を選択するか、次のボタンを使用します。
[Monitoring] に移動
[Monitoring] のナビゲーションパネルで、 [Metrics Explorer] をクリックします。
[Metric] タブが選択されていることを確認します。
[Find resource type and metric] のボックスをクリックして、リソースと指標をメニューから選択するか、リソースと指標の名前を入力します。次の情報を使用して、このテキストボックスのフィールドに入力します。
1. [Resource] で、[Consumer Quota] を選択または入力します。
2. [Metric] で [Allocation quota usage] を選択または入力して、数量に基づく割り当てをモニタリングします。[Rate quota usage] を選択または入力して、頻度に基づく割り当てをモニタリングします。
[Filter]、[Group By]、[Aggregator] の各メニューを使用して、データの表示方法を変更します。たとえば、リソースラベルや指標ラベルごとにグループ化できます。詳しくは、指標の選択をご覧ください。

同様に、割り当て上限または超過エラーを表示するには、まずリソースタイプとして [Consumer Quota] を選択し、次に [Quota limit] または [Quota exceeded error] を選択します。

目的の割り当て使用量の情報が見つかったら、Cloud Monitoring を使用してカスタムダッシュボードとアラートを作成し、継続的なモニタリングによって堅牢なアプリケーションを維持できます。方法については、次のページをご覧ください。

詳細については、Cloud Monitoring のドキュメントの割り当て指標の使用をご覧ください。割り当て特有のアラートポリシーの一般的な例も記載されています。

Cloud Monitoring 参照ガイドで、割り当て指標の詳細なガイドをご覧いただけます。

割り当てのエラー

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

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

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