配額錯誤的原因有很多,例如超出配額值或未正確設定專案配額。如要在發生錯誤時收到快訊,可以建立特定配額錯誤的自訂快訊,操作說明請見「設定配額快訊」一文。
超出速率配額
頻率配額會在預先定義的時間間隔後重設,每個服務的時間間隔不同。詳情請參閱特定服務的配額說明文件。
超過配額值
如果專案在使用服務時超出配額上限, 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,請務必安裝及初始化元件:
- 安裝 gcloud CLI。 - 如果您使用 Cloud Shell,可以略過這個步驟,因為 gcloud CLI 已預先安裝。 
- 初始化 gcloud CLI。 
- 安裝 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 設定帳單專案。
更新 gcloud CLI 元件
如果收到配額指令含有 Invalid choice 的錯誤訊息,您可能安裝了舊版 gcloud CLI。使用下列指令更新 gcloud CLI 元件:
gcloud components update
如要進一步瞭解 gcloud beta quotas 指令和標記,請參閱 Google Cloud CLI 參考資料的 gcloud beta quotas 一節。