Batas dan kuota

Ikuti panduan ini untuk memahami batas dan kuota saat menggunakan Data Manager API.

Batas project

Anda memerlukan project Google Cloud untuk menggunakan Data Manager API. Project Google Cloud menyediakan klien dan kredensial OAuth yang Anda gunakan untuk mengautentikasi permintaan API.

Data Manager API menerapkan pembatasan kapasitas pada setiap project Google Cloud, yang dipisahkan berdasarkan jenis layanan dan operasi (baca versus ubah):

Layanan Operasi Permintaan per hari Permintaan per menit
IngestionService Mutasi (tulis) 100.000 300
IngestionService Baca 100.000 300
Semua layanan lainnya digabungkan Mutasi (tulis) 50.000 300
Semua layanan lainnya digabungkan Baca 50.000 300

Permintaan yang melebihi batas akan ditolak dengan error RESOURCE_EXHAUSTED dan status HTTP 429 Too Many Requests.

Anda dapat mengontrol aplikasi dan melakukan mitigasi pembatasan kapasitas dengan mengurangi jumlah permintaan secara aktif dan membatasi QPS dari sisi klien. Anda juga dapat menyiapkan peringatan kuota dan pemantauan di konsol Google Cloud untuk menerima notifikasi sebelum aplikasi Anda mencapai batasnya.

Nama kuota

Setiap batas sesuai dengan nama dan metrik batas kuota di Google Cloud. Jika permintaan melebihi batas, Data Manager API akan menampilkan nama batas kuota dalam payload detail standar ErrorInfo di bagian metadata.quota_limit:

Nama batas kuota Layanan Operasi Jendela Batas
IngestionMutateRequestsPerDayPerProject IngestionService Mutasi Hari 100.000
IngestionMutateRequestsPerMinutePerProject IngestionService Mutasi Menit 300
IngestionReadRequestsPerDayPerProject IngestionService Baca Hari 100.000
IngestionReadRequestsPerMinutePerProject IngestionService Baca Menit 300
ManagementMutateRequestsPerDayPerProject Semua layanan lainnya Mutasi Hari 50.000
ManagementMutateRequestsPerMinutePerProject Semua layanan lainnya Mutasi Menit 300
ManagementReadRequestsPerDayPerProject Semua layanan lainnya Baca Hari 50.000
ManagementReadRequestsPerMinutePerProject Semua layanan lainnya Baca Menit 300

Periksa metadata.quota_limit di payload ErrorInfo untuk membedakan error batas harian dan per menit serta menentukan apakah akan menjeda sementara dan mencoba lagi dengan mundur, atau menjeda hingga kuota harian direset. Untuk mengetahui detailnya, lihat Error kuota dan pembatasan kapasitas.

Batas permintaan

Berikut batas untuk permintaan tertentu: