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

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

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

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

割り当て値の超過

サービスの使用中にプロジェクトが最大割り当て値を超えた場合、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
            }
          }
        }
      ]
    },

  • 現在の使用状況とピーク使用量を示すグラフを表示するには、Google Cloud コンソールでモニタリング アイコンをクリックします。このアイコンを表示するには、右端までスクロールする必要がある場合があります。

  • 利用可能分を超える割り当てが必要で、サービス ロールアウトが完了するまで待てない場合は、割り当ての調整をリクエストします。

API エラー メッセージ

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

  • user credentials not supported by this API
  • API not enabled in the project
    • no quota project set

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