Pengatur kuota

Halaman ini menjelaskan cara menyesuaikan kuota menggunakan sistem penyesuai kuota.

Pengatur kuota mengamati pemakaian resource Anda dan secara proaktif mengirimkan permintaan penyesuaian kuota atas nama Anda. Memantau penggunaan resource dan mengirimkan permintaan penyesuaian kuota secara proaktif akan mencegah pemadaman layanan yang disebabkan oleh mencapai nilai kuota. Penggunaan pengatur kuota mengurangi kebutuhan untuk memantau peningkatan tak terencana dalam penggunaan resource, dan memungkinkan Anda mengirim lebih sedikit permintaan manual untuk penyesuaian kuota.

Cara kerja pengatur kuota

Saat Anda mengaktifkan pengatur kuota, pengatur kuota akan memantau semua kuota yang berlaku dan menerapkan logika berikut:

  • Pengatur kuota memeriksa apakah penggunaan puncak telah mendekati nilai kuota selama durasi yang ditentukan.
  • Jika demikian, pengatur kuota akan mencoba meningkatkan nilai kuota (biasanya sekitar 10-20%).

Jika memungkinkan untuk meningkatkan nilai kuota, penambahan tersebut akan disetujui dan nilai akan disesuaikan. Anda masih dapat meminta penambahan nilai kuota secara manual kapan saja, terlepas dari apakah pengatur kuota diaktifkan atau tidak.

Pengatur kuota hanya mengirimkan permintaan penyesuaian kuota untuk meningkatkan nilai kuota. Nilai ini tidak mencoba menurunkan nilai. Untuk kuota yang memiliki batas kuota manual, pengatur kuota tidak mengirimkan permintaan penyesuaian kuota.

Anda dapat melihat permintaan yang dibuat oleh pengatur kuota di halaman Kuota & Batas Sistem di konsol Google Cloud. Anda juga dapat menyiapkan pemberitahuan untuk memantau perubahan yang dimulai oleh pengatur kuota.

Batasan

Pengatur kuota memiliki batasan berikut:

  • Setelan pengatur kuota hanya tersedia per project.
  • Setelan pengatur kuota hanya dapat diakses dari konsol Google Cloud.

Ketersediaan

Pengatur kuota memerlukan volume data penggunaan historis yang memadai agar dapat menentukan waktu untuk meminta kuota tambahan secara akurat. Karena alasan ini, opsi untuk mengaktifkan pengatur kuota hanya tersedia pada project dengan aktivitas historis yang cukup untuk mendukung prediksi yang akurat.

Untuk melihat daftar kuota yang memenuhi syarat untuk disesuaikan oleh penyesuai kuota, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Kuota & Batas Sistem:

    Buka Kuota & Batasan Sistem

  2. Klik tab Konfigurasi untuk melihat daftar.

    Atau, lihat tabel berikut:

    Layanan Kuota
    Compute Engine API CPU C2
    Compute Engine API CPU C2D
    Compute Engine API CPU C3
    Compute Engine API CPU
    Compute Engine API CPU per kelompok VM
    Compute Engine API Alamat IPv4 eksternal regional yang digunakan
    Compute Engine API CPU N2
    Compute Engine API CPU N2D
    Compute Engine API SSD Persistent Disk (GB)
    Compute Engine API Persistent Disk Standar (GB)
    Compute Engine API GPU NVIDIA A100 80 GB yang dapat dihentikan
    Compute Engine API GPU NVIDIA A100 yang dapat dihentikan
    Compute Engine API GPU NVIDIA H100 yang dapat dihentikan
    Compute Engine API GPU NVIDIA H100 MEGA yang dapat dihentikan
    Compute Engine API GPU NVIDIA K80 yang dapat dihentikan
    Compute Engine API GPU NVIDIA L4 yang dapat dihentikan
    Compute Engine API GPU Workstation Virtual NVIDIA L4 yang dapat dihentikan
    Compute Engine API GPU NVIDIA P100 yang dapat dihentikan
    Compute Engine API GPU Workstation Virtual NVIDIA P100 yang dapat dihentikan
    Compute Engine API GPU NVIDIA P4 yang dapat dihentikan
    Compute Engine API GPU Workstation Virtual NVIDIA P4 yang dapat dihentikan
    Compute Engine API GPU NVIDIA T4 yang dapat dihentikan
    Compute Engine API GPU Workstation Virtual NVIDIA T4 yang dapat dihentikan
    Compute Engine API GPU NVIDIA V100 preemptible

Mengaktifkan pengatur kuota

Untuk mengaktifkan pengatur kuota, Anda harus memiliki izin IAM berikut:

  • cloudquotas.quotas.update
  • cloudquotas.quotas.get

Untuk mengaktifkan pengatur kuota di project konsol Google Cloud Anda, pilih tab yang sesuai dan ikuti petunjuknya:

Konsol

Untuk mengaktifkan pengatur kuota di Google Cloud project dari konsol Google Cloud, ikuti langkah-langkah berikut:

  1. Buka halaman IAM & Admin > Kuota & Batas Sistem.

    Buka Kuota & Batasan Sistem

  2. Klik tab Konfigurasi.
  3. Klik tombol Aktifkan.

Jika kolom Status menampilkan Diaktifkan, pengatur kuota akan memantau penggunaan Anda dan mengeluarkan permintaan penyesuaian kuota saat penggunaan resource menghampiri nilai kuotanya.

REST

  1. Untuk mengaktifkan pengatur kuota di project Google Cloud menggunakan REST API (Pratinjau), buat permintaan HTTP untuk memperbarui setelan pengatur kuota:

    PATCH https://cloudquotas.googleapis.com/v1beta/projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
    
  2. Dalam isi permintaan, tentukan resource setelan penyesuai kuota dan tetapkan kolom enablement ke ENABLED. Anda juga dapat menentukan ETag, tetapi tindakan ini bersifat opsional:

    {
      name: projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
      enablement: ENABLED
      etag: OPTIONAL_ETAG
    }
    

    Ganti kode berikut:

    • PROJECT_ID_OR_NUMBER: project ID atau nomor project dari project yang ingin Anda aktifkan penyesuai kuotanya.
    • OPTIONAL_ETAG: string ETag opsional untuk setelan penyesuai kuota.

    Tindakan ini akan memperbarui status pengaktifan ke enabled.

gcloud

Untuk mengaktifkan pengatur kuota di project Google Cloud menggunakan gcloud CLI (Pratinjau), ikuti langkah-langkah berikut:

  1. Lakukan autentikasi menggunakan gcloud CLI:

    gcloud auth login
    
  2. Aktifkan setelan pengatur kuota:

    gcloud beta quotas adjuster settings update --project==PROJECT_ID_OR_NUMBER --enablement=enabled
    

    Ganti PROJECT_ID_OR_NUMBER dengan project ID atau nomor project untuk project yang ingin Anda aktifkan penyesuai kuotanya.

  3. Verifikasi status pengaktifan:

    gcloud beta quotas adjuster settings describe --project=PROJECT_ID_OR_NUMBER
    

    Selama Anda memiliki izin yang diperlukan, tindakan ini akan menampilkan status sebagai enabled.

Melihat permintaan penyesuaian kuota

Untuk melihat permintaan penyesuaian kuota, Anda harus memiliki izin IAM berikut:

  • resourcemanager.projects.get
  • serviceusage.services.list
  • serviceusage.quotas.get

Untuk melihat permintaan penyesuaian kuota yang dikeluarkan oleh pengatur kuota:

  1. Buka halaman IAM & Admin > Kuota & Batas Sistem.

    Buka Kuota & Batasan Sistem

  2. Klik tab Permintaan Penambahan. Tampilan Permintaan Penambahan menampilkan permintaan penambahan untuk project Anda, termasuk penambahan yang diminta secara manual dan permintaan yang dikeluarkan oleh pengatur kuota.
  3. Klik kolom Filter.
  4. Pilih Type dari menu, lalu masukkan Auto. Filter ini digunakan untuk permintaan yang dibuat oleh pengatur kuota.

Menyiapkan pemberitahuan pengatur kuota

Untuk menerima pemberitahuan dari pengatur kuota:

  1. Buka halaman IAM & Admin > Kuota & Batas Sistem.

    Buka Kuota & Batasan Sistem

  2. Klik tab Konfigurasi.
  3. Klik Buat Pemberitahuan.
  4. Pilih salah satu atau kedua template pemberitahuan:
    1. Semua penyesuaian oleh Quota Adjuster mengirimkan pemberitahuan setiap kali pengatur kuota mengeluarkan permintaan penyesuaian kuota untuk project.
    2. Error dan kegagalan Pengatur Kuota hanya mengirimkan pemberitahuan saat pengatur kuota mencoba meningkatkan nilai kuota dan tidak dapat melakukannya.
  5. Opsional: Sesuaikan nilai default untuk jumlah waktu minimum antara pemberitahuan dan durasi penutupan otomatis insiden dengan mengklik Tampilkan Opsi.
  6. Pilih Saluran Notifikasi untuk menerima pemberitahuan. Untuk menyesuaikan setelan saluran notifikasi atau membuat saluran notifikasi baru, klik Kelola Saluran Notifikasi.
  7. Klik Buat.

Mengedit atau menghapus pemberitahuan pengatur kuota

Anda dapat mengedit atau menghapus pemberitahuan penyesuai kuota di konsol Google Cloud:

  1. Buka halaman Policies di konsol Cloud Monitoring.

    Buka Kebijakan

  2. Telusuri kebijakan pemberitahuan pengatur kuota Anda. kebijakan pemberitahuan pengatur kuota memiliki nama berikut:

    • Quota adjuster errors and failures
    • All adjustments by quota adjuster
  3. Di baris yang menampilkan kebijakan pemberitahuan penyesuai kuota, klik Lihat lainnya.

  4. Klik Edit atau Hapus.

Menonaktifkan pengatur kuota

Untuk menonaktifkan pengatur kuota, Anda harus memiliki izin IAM berikut:

  • cloudquotas.quotas.update
  • cloudquotas.quotas.get

Untuk menonaktifkan pengatur kuota di project konsol Google Cloud, pilih tab yang sesuai dan ikuti petunjuknya:

Konsol

  1. Buka halaman IAM & Admin > Kuota & Batas Sistem.

    Buka Kuota & Batasan Sistem

  2. Klik tab Konfigurasi.
  3. Klik tombol Aktifkan. Tombol akan berubah menjadi abu-abu.

Jika tombol berwarna abu-abu dan kolom status menampilkan Tidak Aktif, pengatur kuota tidak lagi memantau penggunaan Anda atau mengeluarkan permintaan penyesuaian kuota.

REST

  1. Untuk menonaktifkan pengatur kuota di project Google Cloud menggunakan REST API (Pratinjau), buat permintaan HTTP untuk memperbarui setelan pengatur kuota:

    PATCH https://cloudquotas.googleapis.com/v1beta/projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
    
  2. Dalam isi permintaan, tentukan resource setelan penyesuai kuota dan tetapkan kolom enablement ke DISABLED. Anda juga dapat menentukan ETag, tetapi tindakan ini bersifat opsional:

    {
      name: projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
      enablement: DISABLED
      etag: OPTIONAL_ETAG
    }
    

    Ganti kode berikut:

    • PROJECT_ID_OR_NUMBER: project ID atau nomor project dari project yang penyesuai kuotanya ingin Anda nonaktifkan.
    • OPTIONAL_ETAG: string ETag opsional untuk setelan penyesuai kuota.

    Tindakan ini akan memperbarui status pengaktifan ke disabled.

gcloud

Untuk menonaktifkan pengatur kuota di project Google Cloud menggunakan gcloud CLI (Pratinjau), ikuti langkah-langkah berikut:

  1. Lakukan autentikasi ke gcloud CLI:

    gcloud auth login
    
  2. Nonaktifkan setelan pengatur kuota:

    gcloud beta quotas adjuster settings update --project==PROJECT_ID_OR_NUMBER --enablement=disabled
    

    Ganti PROJECT_ID_OR_NUMBER dengan project ID atau nomor project dari project yang ingin Anda nonaktifkan penyesuai kuotanya.

  3. Verifikasi status pengaktifan:

    gcloud beta quotas adjuster settings describe --project=PROJECT_ID_OR_NUMBER
    

    Selama Anda memiliki izin yang diperlukan, tindakan ini akan menampilkan status sebagai disabled.

Memecahkan masalah penolakan penambahan kuota

Penambahan kuota yang dimulai oleh pengatur kuota mungkin akan ditolak. Hal ini terkadang terjadi saat Google Cloud tidak dapat meningkatkan kuota untuk project, resource, atau region tertentu melebihi nilai tertentu. Dalam skenario ini, Anda masih dapat meminta penambahan kuota manual.

Untuk menerima notifikasi saat permintaan penyesuaian kuota yang dibuat oleh pengatur kuota ditolak, siapkan notifikasi pengatur kuota.