QuotaFailure

Kota kontrolünün nasıl başarısız olduğunu açıklar.

Örneğin, arayan proje için günlük sınır aşılırsa bir hizmet, proje kimliğini ve aşılan kota sınırının açıklamasını içeren bir QuotaFailure ayrıntısıyla yanıt verebilir. Çağrı yapan proje, hizmeti geliştirici konsolunda etkinleştirmediyse hizmet, proje kimliğiyle yanıt verebilir ve service_disabled değerini true olarak ayarlayabilir.

Kota hatasını işleme hakkında diğer ayrıntılar için RetryInfo ve Help türlerine de bakın.

JSON gösterimi 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
Alanlar
violations[]

object (Violation)

Tüm kota ihlallerini açıklar.

İhlal

Tek bir kota ihlalini açıklamak için kullanılan mesaj türü. Örneğin, günlük kota veya aşılan özel bir kota.

JSON gösterimi 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
Alanlar
subject

string

Kota kontrolünün başarısız olduğu konu. Örneğin, "clientip:" veya "project:".
description

string

Kota kontrolünün neden başarısız olduğuna dair açıklama. Müşteriler, hizmetin herkese açık dokümanlarında kota yapılandırması hakkında daha fazla bilgi edinmek veya geliştirici konsolunda ayarlamak için ilgili kota sınırını bulmak üzere bu açıklamayı kullanabilir.

Örneğin: "Service disabled" (Hizmet devre dışı) veya "Daily Limit for read operations exceeded" (Okuma işlemleri için günlük sınır aşıldı).
apiService

string

QuotaFailure.Violation öğesinin kaynağı olan API hizmeti. Bazı durumlarda kota sorunları, çağrılan API hizmeti dışında bir API hizmetinden kaynaklanır. Başka bir deyişle, çağrılan API hizmetinin bağımlılığı QuotaFailure'nın nedeni olabilir ve bu alanda bağımlı API hizmetinin adı bulunur.

Örneğin, çağrılan API Kubernetes Engine API (container.googleapis.com) ise ve Kubernetes Engine API'nin kendisinde bir kota ihlali meydana gelirse bu alan "container.googleapis.com" olur. Öte yandan, kota ihlali Kubernetes Engine API, Compute Engine API'de (compute.googleapis.com) sanal makineler oluştururken gerçekleşirse bu alan "compute.googleapis.com" olur.
quotaMetric

string

İhlal edilen kotanın metriği. Kota metriği, API istekleri veya CPU'lar gibi kullanımı ölçmek için adlandırılmış bir sayaçtır. Bir hizmette etkinlik gerçekleştiğinde (ör. sanal makine ayırma) bir veya daha fazla kota metriği etkilenebilir.

Örneğin, "compute.googleapis.com/cpus_per_vm_family", "storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

İhlal edilen kotanın kimliği. "Limit adı" olarak da bilinen bu, bir API hizmeti bağlamındaki kotanın benzersiz tanımlayıcısıdır.

Örneğin, "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

İhlal edilen kotanın boyutları. Küresel olmayan her kota, bir dizi boyutta uygulanır. Kota metriği neyin sayılacağını tanımlarken boyutlar, sayacın hangi yönler için artırılması gerektiğini belirtir.

Örneğin, "VM ailesi başına bölge başına CPU" kotası, "compute.googleapis.com/cpus_per_vm_family" metriği için "bölge" ve "vm_family" boyutlarında bir sınır uygular. İhlal "us-central1" bölgesinde ve "n1" sanal makine ailesi için gerçekleştiyse quotaDimensions şu şekilde olur:

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

Kota genel olarak uygulandığında quotaDimensions her zaman boş olur.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaValue

string (int64 format)

QuotaFailure sırasında zorunlu kılınan kota değeri.

Örneğin, CPU sayısı için QuotaFailure sırasında zorunlu kılınan kota değeri "10" ise bu alanın değeri bu miktarı yansıtır.
futureQuotaValue

string (int64 format)

İhlal sırasında kullanıma sunulan yeni kota değeri. Kullanıma sunma süreci tamamlandığında bu değer, quotaValue yerine zorunlu kılınır. İhlal sırasında kullanıma sunma işlemi devam etmiyorsa bu alan ayarlanmaz.

Örneğin, ihlal sırasında CPU sayısı kotasını 10'dan 20'ye değiştiren bir kullanıma sunma işlemi devam ediyorsa bu alanın değeri 20 olur.