QuotaFailure

說明配額檢查失敗的原因。

舉例來說，如果呼叫專案超過每日上限，服務可能會傳回 QuotaFailure 詳細資料，其中包含專案 ID 和超過配額上限的說明。如果呼叫專案尚未在開發人員控制台中啟用服務，服務可能會傳回專案 ID，並將 service_disabled 設為 true。

如要進一步瞭解如何處理配額失敗問題，請參閱 RetryInfo 和 Help 類型。

JSON 表示法 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
欄位
violations[]

object (Violation)

說明所有配額違規事項。

違規事項

用於說明單一配額違規事項的訊息類型。例如超出每日配額或自訂配額。

JSON 表示法 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
欄位
subject

string

配額檢查失敗的主體。例如「clientip:」或「project:」。
description

string

說明配額檢查失敗的原因。用戶可以透過這項說明，在服務的公開說明文件中進一步瞭解配額設定，或透過開發人員控制台找出相關配額限制並進行調整。

例如：「服務已停用」或「超過讀取作業的每日限制」。
apiService

string

QuotaFailure.Violation 的來源 API 服務。在某些情況下，配額問題並非源自於呼叫的 API 服務，換句話說，呼叫的 API 服務的依附元件可能是 QuotaFailure 的原因，而這個欄位會顯示依附元件 API 服務名稱。

舉例來說，如果呼叫的 API 是 Kubernetes Engine API (container.googleapis.com)，且 Kubernetes Engine API 本身發生配額違規情形，這個欄位就會是「container.googleapis.com」。另一方面，如果 Kubernetes Engine API 在 Compute Engine API (compute.googleapis.com) 中建立 VM 時發生配額違規情形，這個欄位就會是「compute.googleapis.com」。
quotaMetric

string

違反配額的指標。配額指標是具名的計數器，用於測量用量，例如 API 要求或 CPU。當服務中發生活動 (例如虛擬機器分配作業) 時，可能會影響一或多個配額指標。

例如「compute.googleapis.com/cpus_per_vm_family」、「storage.googleapis.com/internet_egress_bandwidth」。
quotaId

string

違反配額的 ID。也稱為「限制名稱」，這是 API 服務環境中配額的不重複 ID。

例如「CPUS-PER-VM-FAMILY-per-project-region」。
quotaDimensions

map (key: string, value: string)

違反配額的維度。系統會針對一組維度強制執行所有非全域配額。配額指標會定義要計算的項目，維度則會指定計數器應增加的方面。

舉例來說，「每個 VM 系列的每個區域 CPU 數量」配額會對「compute.googleapis.com/cpus_per_vm_family」指標，以及「region」和「vm_family」維度強制執行限制。如果違規行為發生在「us-central1」區域，且 VM 系列為「n1」，則 quotaDimensions 會是：

{ "region": "us-central1", "vm_family": "n1", }

如果配額是全域強制執行，quotaDimensions 一律會是空白。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
quotaValue

string (int64 format)

QuotaFailure當時的強制配額值。

舉例來說，如果 QuotaFailure時 CPU 數量的強制配額值為「10」，則這個欄位的值會反映這個數量。
futureQuotaValue

string (int64 format)

違規時推出的新配額值。推出作業完成後，系統會強制使用這個值，取代 quotaValue。如果違規時沒有正在進行的推出作業，就不會設定這個欄位。

舉例來說，如果違規時正在進行推出作業，將 CPU 配額從 10 個變更為 20 個，則這個欄位的值會是 20。