Memecahkan masalah error kuota

Anda mungkin menerima error kuota karena sejumlah alasan, seperti melebihi nilai kuota atau tidak menetapkan project kuota dengan benar. Jika ingin diberi tahu saat terjadi error pada masa mendatang, 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 maksimumnya 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. Perlu diperhatikan 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 mungkin juga menerima error ini jika melebihi 300 MB per detik. Untuk informasi selengkapnya, lihat Streaming insert.
  • Jika Anda melampaui 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 tarif, 403 RATE_LIMIT_EXCEEDED akan ditampilkan.
  • Jika Anda melebihi nilai kuota menggunakan gRPC, Google Cloud akan menampilkan error ResourceExhausted. Cara error ini muncul bagi Anda bergantung pada layanan.
  • Jika Anda melampaui nilai kuota menggunakan perintah Google Cloud CLI, gcloud CLI akan menampilkan pesan error yang melebihi kuota dan menampilkan 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 berlangsung secara bertahap. Artinya, 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 melihat pesan error ini, berarti 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 grafik yang menunjukkan penggunaan saat ini dan puncak, di Konsol Google Cloud, klik ikon pemantauan monitoring. Anda mungkin perlu men-scroll ke kanan untuk melihat ikon ini.

  • Jika Anda memerlukan kuota lebih banyak dari yang dapat Anda akses, dan tidak dapat menunggu hingga peluncuran layanan selesai, minta penyesuaian kuota.

Pesan error API

Jika project kuota Anda (disebut juga project penagihan) tidak ditetapkan dengan benar, permintaan API mungkin menampilkan pesan error berikut:

  • user credentials not supported by this API
  • API not enabled in the project
    • no quota project set

Error ini dan error lainnya biasanya dapat diperbaiki dengan menetapkan project kuota. Untuk mengetahui informasi selengkapnya, lihat Ringkasan project kuota.