割り当てエラーをトラブルシューティングする

割り当て値を超えた場合や、プロジェクトに対して割り当てが正しく設定されていない場合など、いくつかの理由で割り当てエラーが発生する可能性があります。エラーが発生した場合にアラートを受け取るようにするには、割り当てアラートを設定するで説明されているように、特定の割り当てエラーに対するカスタムアラートを作成します。

レートに基づく割り当ての超過

レート割り当ては、各サービスに固有の事前定義された時間間隔が経過するとリセットされます。詳細については、特定のサービスの割り当てに関するドキュメントをご覧ください。

割り当て値の超過

サービスの使用中にプロジェクトが最大割り当て値を超えた場合、Google Cloud はサービスへのアクセス方法に基づいてエラーを返します。

API リクエストで割り当て値を超過した場合、Google Cloud は HTTP 413 REQUEST ENTITY TOO LARGE ステータスコードを返します。本番環境で BigQuery のレガシーストリーミング API を使用している場合、HTTP リクエストが 10 MB を超えると、413 REQUEST ENTITY TOO LARGE ステータスコードが返されることがあります。このエラーは、1 秒あたり 300 MB を超えた場合にも発生することがあります。詳細については、ストリーミング挿入をご覧ください。
HTTP / REST リクエストで割り当て値を超過した場合、Google Cloud は HTTP 429 TOO MANY REQUESTS ステータスコードを返します。
Compute Engine の割り当てを超過した場合、Google Cloud は通常、API、HTTP / REST、gRPC のいずれの場合でも HTTP 403 QUOTA_EXCEEDED ステータスコードを返します。割り当てがレートに基づく割り当ての場合、403 RATE_LIMIT_EXCEEDED が返されます。
gRPC を使用して割り当て値を超過した場合、Google Cloud は ResourceExhausted エラーを返します。このエラーがどのように表示されるかは、サービスによって異なります。
Google Cloud CLI コマンドを使用して割り当て値を超過した場合、gcloud CLI は割り当て超過のエラーメッセージを出力するとともに、終了コード 1 を返します。
サービスロールアウト中に QUOTA_EXCEEDED メッセージを受信した場合は、次のセクションをご覧ください。

サービスロールアウト中の割り当て値の超過

Google Cloud は、リソースと API のデフォルトの割り当て値を変更することがあります。これらの変更は段階的に行われるため、新しいデフォルト割り当てのロールアウト中に、Google Cloud コンソールに表示される割り当て値に、実際に使用できる新しい割り当て値が反映されていないことがあります。

割り当てのロールアウトが進行中の場合は、「The future limit is the new default quota that will be available after a service rollout completes.」というエラーメッセージが表示されることがあります。このエラーメッセージが表示された場合は、Google Cloud コンソールの表示内容が異なっている場合でも、引用されている割り当て値と将来の値が正しいことを意味します。

詳細については、監査ログを表示して QUOTA_EXCEEDED メッセージを探してください。

    "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

現在の使用量とピーク使用量を示すグラフを表示するには、[割り当てとシステム上限] ページに移動し、[モニタリング] をクリックします。表の末尾に移動することが必要な場合があります。
割り当て量を引き上げる必要がある場合は、割り当ての調整をリクエストできます。

API エラーメッセージ

割り当てプロジェクト（課金プロジェクトとも呼ばれます）が正しく設定されていない場合は、API リクエストで次のようなエラーメッセージが返される可能性があります。

User credentials not supported by this API
API not enabled in the project
No quota project set

多くの場合、こうしたエラーやその他のエラーは割り当てプロジェクトを設定することで解決できます。詳細については、割り当てプロジェクトの概要をご覧ください。

Google Cloud CLI エラー

このセクションでは、Google Cloud CLI（gcloud CLI）の使用を開始する際に発生する一般的な問題について説明します。

インストールと初期化

Cloud Quotas で gcloud CLI を使用するには、コンポーネントをインストールして初期化してください。

gcloud CLI をインストールする。

Cloud Shell を使用している場合は、gcloud CLI がプリインストールされているため、このステップをスキップできます。
gcloud CLI を初期化する。
次のコマンドを実行して、アルファ版コンポーネントをインストールします。
```
gcloud components install alpha
```

割り当てプロジェクトを設定する

割り当てプロジェクトを設定していない場合は、gcloud CLI コマンドで次のようなエラーが返される可能性があります。

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

この問題を解決するには、gcloud CLI コマンドに --billing-project フラグを追加して割り当てプロジェクトを明示的に設定するか、gcloud config set billing/quota_project CURRENT_PROJECT を再実行して割り当てプロジェクトを現在のプロジェクトとして設定します。

詳しくは以下をご覧ください。

割り当てプロジェクトをプログラマティックに設定する。
gcloud CLI を使用して課金プロジェクトを設定する。

gcloud CLI コンポーネントを更新する

quotas コマンドに Invalid choice が含まれているというエラーが表示された場合は、古いバージョンの gcloud CLI がインストールされている可能性があります。次のコマンドを使用して、gcloud CLI コンポーネントを更新します。

gcloud components update

gcloud alpha quotas コマンドとフラグの詳細については、Google Cloud CLI リファレンスの gcloud alpha quotas セクションをご覧ください。