QuotaFailure

Menjelaskan penyebab kegagalan pemeriksaan kuota.

Misalnya, jika batas harian terlampaui untuk project yang melakukan panggilan, layanan dapat merespons dengan detail QuotaFailure yang berisi ID project dan deskripsi batas kuota yang terlampaui. Jika project yang memanggil belum mengaktifkan layanan di konsol developer, layanan dapat merespons dengan project ID dan menyetel service_disabled ke benar (true).

Lihat juga jenis RetryInfo dan Bantuan untuk mengetahui detail lainnya tentang penanganan kegagalan kuota.

Representasi JSON 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
Kolom
violations[]

object (Violation)

Menjelaskan semua pelanggaran kuota.

Pelanggaran

Jenis pesan yang digunakan untuk mendeskripsikan satu pelanggaran kuota. Misalnya, kuota harian atau kuota kustom yang terlampaui.

Representasi JSON 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
Kolom
subject

string

Subjek yang menyebabkan pemeriksaan kuota gagal. Misalnya, "clientip:" atau "project:".
description

string

Deskripsi tentang alasan pemeriksaan kuota gagal. Klien dapat menggunakan deskripsi ini untuk mengetahui lebih lanjut konfigurasi kuota dalam dokumentasi publik layanan, atau menemukan batas kuota yang relevan untuk disesuaikan melalui konsol developer.

Misalnya: "Layanan dinonaktifkan" atau "Batas Harian untuk operasi baca terlampaui".
apiService

string

Layanan API tempat QuotaFailure.Violation berasal. Dalam beberapa kasus, masalah Kuota berasal dari Layanan API selain yang dipanggil. Dengan kata lain, dependensi Layanan API yang dipanggil dapat menjadi penyebab QuotaFailure, dan kolom ini akan memiliki nama layanan API dependensi.

Misalnya, jika API yang dipanggil adalah Kubernetes Engine API (container.googleapis.com), dan terjadi pelanggaran kuota di Kubernetes Engine API itu sendiri, kolom ini akan menjadi "container.googleapis.com". Di sisi lain, jika pelanggaran kuota terjadi saat Kubernetes Engine API membuat VM di Compute Engine API (compute.googleapis.com), kolom ini akan menjadi "compute.googleapis.com".
quotaMetric

string

Metrik kuota yang dilanggar. Metrik kuota adalah penghitung bernama untuk mengukur penggunaan, seperti permintaan API atau CPU. Saat aktivitas terjadi di layanan, seperti alokasi Virtual Machine, satu atau beberapa metrik kuota mungkin terpengaruh.

Misalnya, "compute.googleapis.com/cpus_per_vm_family", "storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

ID kuota yang dilanggar. Juga dikenal sebagai "nama batas", ini adalah ID unik kuota dalam konteks layanan API.

Misalnya, "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

Dimensi kuota yang dilanggar. Setiap kuota non-global diterapkan pada serangkaian dimensi. Meskipun metrik kuota menentukan apa yang harus dihitung, dimensi menentukan aspek yang harus ditingkatkan oleh penghitung.

Misalnya, kuota "CPU per region per VM family" menerapkan batas pada metrik "compute.googleapis.com/cpus_per_vm_family" pada dimensi "region" dan "vm_family". Jika pelanggaran terjadi di region "us-central1" dan untuk family VM "n1", quotaDimensions-nya adalah,

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

Jika kuota diterapkan secara global, quotaDimensions akan selalu kosong.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaValue

string (int64 format)

Nilai kuota yang diterapkan pada saat QuotaFailure.

Misalnya, jika nilai kuota yang diterapkan pada saat QuotaFailure pada jumlah CPU adalah "10", maka nilai kolom ini akan mencerminkan jumlah ini.
futureQuotaValue

string (int64 format)

Nilai kuota baru yang diluncurkan pada saat terjadinya pelanggaran. Setelah peluncuran selesai, nilai ini akan diterapkan sebagai pengganti quotaValue. Jika tidak ada peluncuran yang sedang berlangsung pada saat terjadinya pelanggaran, kolom ini tidak akan ditetapkan.

Misalnya, jika pada saat terjadinya pelanggaran, peluncuran sedang berlangsung yang mengubah kuota jumlah CPU dari 10 menjadi 20, maka 20 akan menjadi nilai kolom ini.