排解配額錯誤

配額錯誤的原因有很多，例如超出配額值或未正確設定專案配額。如要在發生錯誤時收到快訊，可以建立特定配額錯誤的自訂快訊，操作說明請見「設定配額快訊」一文。

超出速率配額

頻率配額會在預先定義的時間間隔後重設，每個服務的時間間隔不同。詳情請參閱特定服務的配額說明文件。

超過配額值

如果專案在使用服務時超出配額上限， Google Cloud會根據您存取服務的方式傳回錯誤：

  • 如果 API 要求超出配額值， Google Cloud 會傳回 HTTP 413 REQUEST ENTITY TOO LARGE 狀態碼。請注意，在正式環境中使用 BigQuery 舊版串流 API 時，如果 HTTP 要求大於 10 MB，您可能會收到 413 REQUEST ENTITY TOO LARGE 狀態碼。如果每秒超過 300 MB，也可能會收到這則錯誤訊息。詳情請參閱串流資料插入。
  • 如果您是在傳送 HTTP/REST 要求時超出配額值， Google Cloud 會傳回 HTTP 429 TOO MANY REQUESTS 狀態碼。
  • 如果超出 Compute Engine 配額， Google Cloud 通常會傳回 HTTP 403 QUOTA_EXCEEDED 狀態碼，無論是透過 API、HTTP/REST 或 gRPC 傳送要求都一樣。如果配額是速率配額，則會傳回 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 控制台前往「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面，然後按一下「監控」。你可能需要前往表格結尾。

  • 如需更多配額，可以申請調整配額。

超過專案配額

如要進一步瞭解如何申請增加專案配額，請參閱「專案配額申請」支援文章。

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) 時的常見問題。

安裝及初始化

如要使用 gcloud CLI 存取 Cloud Quotas，請務必安裝及初始化元件：

  1. 安裝 gcloud CLI。

    如果您使用 Cloud Shell，可以略過這個步驟，因為 gcloud CLI 已預先安裝。

  2. 初始化 gcloud CLI。

  3. 安裝 Beta 版元件 執行下列指令：

    gcloud components install beta

設定配額專案

如果尚未設定配額專案，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 元件

如果收到配額指令含有 Invalid choice 的錯誤訊息，您可能安裝了舊版 gcloud CLI。使用下列指令更新 gcloud CLI 元件：

gcloud components update

如要進一步瞭解 gcloud beta quotas 指令和標記，請參閱 Google Cloud CLI 參考資料的 gcloud beta quotas 一節。