Kuota dan batas

Halaman ini menjelaskan batas kuota API Gateway.

Batas pada API, konfigurasi API, dan gateway

API Gateway menerapkan batas berikut pada API, konfigurasi API, dan gateway:

API - total 50
Konfigurasi API - 100 per API
Gateway - 50 per wilayah

Jika Anda mencoba membuat konfigurasi API kedua sebelum pembuatan konfigurasi API pertama untuk API yang sama selesai, satu atau kedua konfigurasi mungkin tidak tersedia untuk digunakan nanti di Gateway.

Batas rasio permintaan

Secara default, batas rasio 10.000.000 unit kuota per 100 detik per project produsen layanan diberlakukan. Satu unit kuota digunakan untuk setiap panggilan ke services.check dan untuk setiap operasi yang dilaporkan oleh services.report.

Batas ukuran payload

Batas berikut berlaku khusus untuk ukuran payload maksimum untuk traffic melalui gateway yang di-deploy:

Batas	Jumlah
Ukuran permintaan	32 megabyte
Ukuran respons	32 megabyte
Ukuran respons penyulihan kode gRPC	1 megabyte
Ukuran permintaan transcoding gRPC	1 megabyte

Streaming tidak didukung.

Batas ukuran header

Batas berikut berlaku khusus untuk ukuran header maksimum untuk traffic melalui gateway yang di-deploy:

Batas	Jumlah
Ukuran header permintaan	60 kilobyte

Layanan backend yang dipanggil oleh Gateway API mungkin memiliki batas yang lebih rendah.

Cara menambah kuota

Permintaan penyesuaian Kuota Cloud akan ditinjau. Jika permintaan penyesuaian kuota Anda memerlukan peninjauan, Anda akan menerima email yang menyatakan bahwa permintaan Anda telah diterima. Jika Anda memerlukan bantuan lebih lanjut, balas email ini. Setelah meninjau permintaan Anda, Anda akan menerima email notifikasi yang menunjukkan apakah permintaan Anda disetujui atau tidak. Anda dapat meminta penyesuaian kuota menggunakan konsol Google Cloud , Cloud Quotas API, atau Google Cloud CLI. Petunjuk berikut menunjukkan cara meminta nilai kuota baru menggunakan konsol Google Cloud atau dengan membuat permintaan REST ke Cloud Quotas API.

Konsol

Untuk meminta penyesuaian kuota, ikuti langkah-langkah berikut:

Di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits:
Buka Quotas & System Limits
Jika diminta untuk memilih project, pilih project yang ingin Anda sesuaikan.
Temukan kuota yang ingin Anda sesuaikan, lalu buka dialog Perubahan kuota:
- Kuota yang tidak ada dalam tabel:
  - Telusuri kuota Anda di kotak penelusuran Filter. Jangan tentukan wilayah atau zona (jika berlaku) karena kuota yang tidak memiliki nilai penggunaan atau yang disesuaikan tidak ditampilkan dalam tabel.
  - Temukan entri apa pun untuk kuota Anda dalam tabel. Ini dapat berupa entri default atau entri apa pun dengan histori, terlepas dari region atau zona.
  - Di baris untuk entri, klik Tindakan lainnya > Konfigurasi wilayah/zona tambahan.
  - Pilih wilayah atau zona yang ingin Anda sesuaikan. Klik Edit.
- Semua kuota lainnya:
  - Telusuri kuota Anda di kotak penelusuran Filter.
  - Di baris untuk entri, centang kotak untuk kuota Anda.
  - Klik Edit.
Dialog Quota changes akan muncul.
Jika Anda melihat link Minta kuota lebih tinggi di atas kolom Nilai baru dan Anda ingin menambah nilai kuota melampaui jumlah yang ditunjukkan di layar, ikuti link tersebut. Isi formulirnya, kirim, dan lewati langkah-langkah berikutnya di sini. Jika tidak, lanjutkan mengikuti panduan ini.
Di kolom Nilai baru, masukkan nilai kuota yang ingin Anda tingkatkan. Jika kolom Deskripsi permintaan muncul, masukkan deskripsi. Klik Done.
- Jika Anda melihat kotak centang dengan teks "Saya memahami bahwa permintaan ini akan menghapus semua penggantian", nilai kuota Anda ditetapkan di bawah nilai default. Menyesuaikan nilai kuota ke atau di luar nilai default akan menghapus penggantian. Untuk melanjutkan, centang kotak. Pelajari lebih lanjut penggantian kuota.
Jika tombol Berikutnya muncul, klik Berikutnya dan isi detail kontak Anda di layar berikutnya.
Klik Submit request.

Jika Anda mendapati bahwa Anda tidak dapat meminta penyesuaian dari konsol, mintalah penambahan dari Cloud Customer Care.

Untuk mempelajari lebih lanjut cara kerja proses penambahan kuota, lihat Tentang penyesuaian kuota.

Mengelompokkan permintaan penyesuaian kuota

Anda dapat membuat permintaan massal untuk penyesuaian kuota dengan mencentang kotak untuk setiap kuota yang ingin disertakan. Namun, pengelompokan permintaan dapat meningkatkan waktu yang diperlukan untuk Google Cloud meninjau permintaan Anda.

Untuk mengurangi waktu peninjauan, kelompokkan permintaan penyesuaian kuota menurut produk dan area. Misalnya, jika Anda ingin meminta penyesuaian kuota VM Compute Engine dan jaringan, buat satu permintaan untuk kuota jaringan dan permintaan lain untuk kuota VM Compute Engine.

REST

Untuk meminta penyesuaian kuota dari Cloud Quotas API, gunakan contoh kode berikut. Isi placeholder yang dapat diedit dengan nilai Anda. Untuk mempelajari kolom placeholder, lihat deskripsi setelah contoh kode.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Ganti kode berikut:

PROJECT_NUMBER: Nomor project Google Cloud Anda. Anda dapat menemukan nomor project di halaman Selamat Datang di konsol Google Cloud atau dengan menjalankan perintah gcloud CLI berikut:
```
PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"
```
QUOTA_PREFERENCE_ID: ID preferensi kuota yang Anda perbarui.
QUOTA_ID: ID kuota yang Anda perbarui.
SERVICE_ID: ID Google Cloud yang kuota yang Anda sesuaikan termasuk di dalamnya. Biasanya dalam bentuk SERVICE_NAME.googleapis.com. Misalnya, nama layanan Compute Engine adalah compute.googleapis.com.
DIMENSION_1: Jenis dimensi yang ingin Anda sesuaikan—misalnya, region atau zone—. Anda dapat menyertakan beberapa dimensi. Pisahkan setiap dimensi dengan mengikuti nilainya— misalnya, VALUE_1—dengan koma. Untuk menyesuaikan semua dimensi kuota, hapus baris ini.
VALUE_1: Nilai dimensi sebelumnya. Misalnya, jika dimensi sebelumnya adalah region, masukkan wilayah seperti us-central1.
JUSTIFICATION: Alasan permintaan ini.
EMAIL: Alamat email yang dapat digunakan sebagai kontak, jika Google Cloud membutuhkan informasi lebih lanjut untuk membuat keputusan sebelum kuota tambahan dapat diberikan.

Contoh permintaan

Berikut adalah contoh permintaan penambahan nilai kuota untuk kuota Compute Engine PUS-PER-GPU-FAMILY-per-project-region. Permintaan ini meminta nilai kuota 100 untuk mesin dari kelompok GPU NVIDIA_H100 yang berada di region us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}