Memecahkan masalah error kuota

Anda mungkin menerima error kuota karena beberapa alasan, seperti melampaui nilai kuota atau tidak menyetel kuota di project dengan benar. Jika ingin menerima pemberitahuan saat terjadi error, Anda dapat membuat pemberitahuan kustom untuk error kuota tertentu, seperti yang dijelaskan dalam Menyiapkan pemberitahuan kuota.

Melebihi kuota kapasitas

Kuota kapasitas direset setelah interval waktu yang telah ditentukan yang berlaku khusus untuk setiap layanan. Untuk informasi selengkapnya, lihat dokumentasi kuota untuk layanan tertentu.

Melebihi nilai kuota

Jika project Anda melebihi nilai kuota maksimum saat menggunakan layanan, Google Cloud akan menampilkan error berdasarkan cara Anda mengakses layanan:

  • Jika Anda melampaui nilai kuota dengan permintaan API, Google Cloud akan menampilkan kode status HTTP 413 REQUEST ENTITY TOO LARGE. Perhatikan bahwa saat menggunakan BigQuery Streaming API lama di lingkungan produksi, Anda mungkin menerima kode status 413 REQUEST ENTITY TOO LARGE jika permintaan HTTP Anda lebih besar dari 10 MB. Anda juga dapat menerima error ini jika Anda melebihi 300 MB per detik. Untuk mengetahui informasi selengkapnya, lihat Streaming insert.
  • Jika Anda melebihi nilai kuota dengan permintaan HTTP/REST, Google Cloud akan menampilkan kode status HTTP 429 TOO MANY REQUESTS.
  • Jika Anda melebihi kuota untuk Compute Engine, Google Cloud biasanya akan menampilkan kode status HTTP 403 QUOTA_EXCEEDED, baik dari API, HTTP/REST, atau gRPC. Jika kuota adalah kuota kecepatan, maka 403 RATE_LIMIT_EXCEEDED akan ditampilkan.
  • Jika Anda melampaui nilai kuota menggunakan gRPC, Google Cloud akan menampilkan error ResourceExhausted. Tampilan error ini bergantung pada layanan.
  • Jika Anda melampaui nilai kuota menggunakan perintah Google Cloud CLI, gcloud CLI akan menampilkan pesan error yang melebihi kuota dan kembali dengan kode keluar 1.
  • Jika Anda menerima pesan QUOTA_EXCEEDED selama peluncuran layanan, lihat bagian berikut.

Melebihi nilai kuota selama peluncuran layanan

Google Cloud terkadang mengubah nilai kuota default untuk resource dan API. Perubahan ini terjadi secara bertahap, yang berarti bahwa selama peluncuran kuota default baru, nilai kuota yang muncul di konsol Google Cloud mungkin tidak mencerminkan nilai kuota baru yang tersedia untuk Anda.

Jika peluncuran kuota sedang berlangsung, Anda mungkin menerima pesan error yang menyatakan The future limit is the new default quota that will be available after a service rollout completes. Jika Anda melihat pesan error ini, nilai kuota yang dikutip dan nilai mendatang sudah benar, meskipun nilai yang muncul di Google Cloud konsol berbeda.

  • Untuk informasi tambahan, lihat log audit dan cari pesan QUOTA_EXCEEDED.

        "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

  • Untuk melihat diagram yang menunjukkan penggunaan saat ini dan puncak, di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits lalu klik Monitoring. Anda mungkin perlu membuka akhir tabel.

  • Jika memerlukan lebih banyak kuota, Anda dapat meminta penyesuaian kuota.

Melebihi kuota project

Untuk mengetahui informasi selengkapnya tentang cara meminta kuota project tambahan, lihat artikel dukungan Permintaan kuota project.

Pesan error API

Jika project kuota (juga disebut project penagihan) tidak disetel dengan benar, permintaan API mungkin menampilkan pesan error yang mirip dengan berikut ini:

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

Error ini dan error lainnya sering kali dapat diperbaiki dengan menyetel project kuota. Untuk mengetahui informasi selengkapnya, lihat Ringkasan project kuota.

Error Google Cloud CLI

Bagian ini menjelaskan masalah umum yang terjadi saat mulai menggunakan Google Cloud CLI (gcloud CLI).

Menginstal dan melakukan inisialisasi

Untuk menggunakan gcloud CLI untuk Kuota Cloud, pastikan untuk menginstal dan melakukan inisialisasi komponen:

  1. Instal gcloud CLI.

    Jika Anda menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah diinstal sebelumnya.

  2. Lakukan inisialisasi gcloud CLI.

  3. Instal komponen beta dengan menjalankan perintah berikut:

    gcloud components install beta

Menetapkan project kuota Anda

Jika Anda belum menyetel project kuota, perintah gcloud CLI mungkin menampilkan error seperti berikut:

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.

Untuk mengatasi masalah ini, tambahkan tanda --billing-project pada perintah gcloud CLI untuk menetapkan project kuota secara eksplisit, atau jalankan ulang gcloud config set billing/quota_project CURRENT_PROJECT untuk menetapkan project kuota sebagai project saat ini.

Untuk informasi selengkapnya, lihat referensi berikut:

Memperbarui komponen gcloud CLI

Jika Anda menerima error bahwa perintah kuota berisi Invalid choice, Anda mungkin telah menginstal gcloud CLI versi lama. Update komponen gcloud CLI dengan perintah berikut:

gcloud components update

Untuk mengetahui detail selengkapnya tentang perintah dan flag gcloud quotas, lihat bagian gcloud quotas dalam referensi Google Cloud CLI.

Langkah berikutnya