Memecahkan masalah error kuota

Anda mungkin menerima error kuota karena sejumlah alasan, seperti melebihi nilai kuota atau tidak menetapkan kuota pada 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 melebihi nilai kuota dengan permintaan API, Google Cloud akan menampilkan kode status HTTP 413 REQUEST ENTITY TOO LARGE. Perhatikan bahwa saat menggunakan API streaming lama BigQuery di lingkungan produksi, Anda mungkin menerima kode status 413 REQUEST ENTITY TOO LARGE jika permintaan HTTP Anda lebih besar dari 10 MB. Anda juga mungkin menerima error ini jika 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 menampilkan kode status HTTP 403 QUOTA_EXCEEDED, baik dari API, HTTP/REST, atau gRPC. Jika kuota adalah kuota kapasitas, 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 yang muncul di Konsol Google Cloud 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 menampilkan penggunaan saat ini dan puncak, buka halaman Quotas & System Limits, lalu klik Monitoring. Anda mungkin perlu membuka akhir tabel.

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

Pesan error API

Jika project kuota Anda (juga disebut project penagihan) tidak ditetapkan 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 menetapkan project kuota. Untuk mengetahui informasi selengkapnya, lihat Ringkasan project kuota.

Error Google Cloud CLI

Bagian ini menjelaskan masalah umum yang dialami saat memulai 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 menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah diinstal sebelumnya.

  2. Lakukan inisialisasi gcloud CLI.

  3. Instal komponen alfa dengan menjalankan perintah berikut:

    gcloud components install alpha

Menetapkan project kuota

Jika Anda belum menetapkan 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 Anda 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:

Mengupdate 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 alpha quotas, lihat bagian kuota gcloud alpha dalam referensi Google Cloud CLI.