Tentang kuota

Gateway API menyediakan kuota, yang memungkinkan Anda mengontrol kecepatan aplikasi dapat memanggil API Anda. Dengan menetapkan kuota, Anda dapat menentukan batas penggunaan untuk melindungi API dari jumlah permintaan yang berlebihan dari aplikasi panggilan. Permintaan yang berlebihan mungkin disebabkan oleh kesalahan ketik sederhana atau dari sistem yang dirancang secara tidak efisien yang melakukan panggilan yang tidak perlu ke API Anda.

Terlepas dari penyebabnya, memblokir traffic dari sumber setelah mencapai tingkat tertentu diperlukan untuk kesehatan API secara keseluruhan. Dengan menetapkan kuota, Anda memastikan bahwa satu aplikasi tidak dapat berdampak negatif pada aplikasi lain yang menggunakan API Anda.

Kuota berlaku untuk seluruh API

Anda menentukan metrik dan batas kuota dalam konfigurasi API, tetapi Gateway API menerapkannya ke API yang memiliki konfigurasi API, bukan hanya ke konfigurasi API tersebut. Setiap kali Anda membuat konfigurasi API, metrik dan batas yang dideklarasikan akan menggantikan metrik dan batas yang dideklarasikan oleh konfigurasi API sebelumnya. Hanya metrik dan batas dari konfigurasi API yang paling baru dibuat yang akan diterapkan.

Hal ini memiliki dua konsekuensi jika API memiliki lebih dari satu konfigurasi API yang di-deploy:

  • Mengubah nilai batas akan mengubahnya untuk setiap gateway API, termasuk gateway yang menayangkan konfigurasi API sebelumnya.

  • Mengganti nama atau menghapus metrik akan meninggalkan konfigurasi kuota yang tidak valid di gateway mana pun yang masih menayangkan konfigurasi API sebelumnya. Permintaan ke metode yang menerapkan kuota dari gateway tersebut akan gagal dengan error HTTP 500 dan pesan Failed to call Service Control Quota.

Untuk menemukan dan memperbaiki konfigurasi kuota yang tidak valid, lihat Permintaan API menampilkan error HTTP 500 untuk metode yang menerapkan kuota.