Mengonfigurasi dimensi Kuota Cloud

Dimensi Kuota Cloud merepresentasikan berbagai cara mengukur penggunaan resource di Google Cloud. Dimensi biasanya berupa wilayah, zona, Google Cloud pengguna, atau atribut produk.

Cloud Quotas API merepresentasikan dimensi sebagai pasangan nilai kunci. key adalah nama dimensi (misalnya, region). value adalah nilai yang ditetapkan untuk dimensi (misalnya, wilayah seperti us-central1).

Misalnya, Compute Engine mengukur penggunaan VM dengan menggunakan dimensi yang berbeda. Dimensi region mengukur jumlah VM yang Anda miliki di region tertentu. Compute Engine juga memiliki sejumlah dimensi atribut produk, termasuk gpu_family. Dimensi gpu_family mengukur jumlah GPU dari keluarga tertentu di project Google Cloud Anda.

Melihat dimensi

Anda dapat melihat dimensi untuk kuota dan batas sistem dengan melihat di konsol, menggunakan Google Cloud CLI, membuat kueri REST API, atau melalui library klien.Google Cloud Untuk melihat dimensi yang belum Anda tentukan nilainya, gunakan gcloud CLI. Gunakan juga gcloud CLI untuk melihat dimensi untuk kuota dan batas sistem yang tidak memiliki dimensi regional atau zona jika project Anda belum menggunakan resource terkait. Bagian ini menunjukkan cara melihat dimensi menggunakan konsol dan menggunakan gcloud CLI.

Konsol

  1. Di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits:

    Buka Quotas & System Limits

    Tabel di halaman ini menampilkan dimensi di kolom Dimensi.

  2. Jika Anda tidak melihat kolom Dimensi, lakukan langkah-langkah berikut. Jika tidak, lewati langkah ini.

    1. Klik Opsi tampilan kolom.
    2. Pilih Dimensi.
    3. Klik Oke. Kolom Dimensi muncul di tabel.
  3. Untuk memfilter hasil, masukkan nama atau nilai properti di kolom di samping Filter.

    • Untuk memfilter menurut produk, mulai masukkan nama produk dan pilih dari daftar yang muncul.
    • Untuk memfilter menurut dimensi, masukkan dimensi Anda menggunakan format berikut: dimension_name:dimension_value. Misalnya, untuk melihat kuota dan batas sistem yang ditentukan untuk region us-central1, masukkan: region:us-central.

Memahami dimensi kosong

Terkadang kolom Dimensi kosong. Hal ini dapat terjadi karena alasan berikut:

  • Nilai kuota atau batas sistem adalah nilai default dan berlaku untuk semua dimensi. Untuk beberapa kuota dan batas sistem, konsol menampilkan baris yang mencantumkan nilai kuota atau batas sistem default untuk referensi. Karena default berlaku untuk semua nilai dimensi, kolom Dimensi kosong. Lihat kolom Name untuk mengidentifikasi entri ini. Kolom Nama menunjukkan entri ini dengan kata "default" dalam tanda kurung di akhir nama kuota atau batas sistem.

    Misalnya, kuota SetIamPolicyRequestsPerMinutePerProject ditentukan pada dimensi region. Konsol menampilkan entri referensi, dan entri untuk setiap wilayah. Di kolom Name, entri referensi tercantum sebagai "SetIAMPolicy requests per minute per region (default)". Untuk entri ini, kolom Dimensi kosong.

  • Tidak ada dimensi yang berlaku. Misalnya, kuota Compute Engine NETWORKS-per-project tidak dikaitkan dengan atribut produk, zona, atau region, sehingga tidak ada dimensi yang ditampilkan.

gcloud

Anda dapat menggunakan gcloud CLI untuk melihat dimensi untuk satu kuota atau batas sistem, atau untuk semua kuota dan batas sistem yang terkait dengan produk tertentu. Melihat dimensi untuk satu kuota atau batas sistem biasanya lebih cepat daripada melihat dimensi untuk semua kuota dan batas sistem yang terkait dengan suatu produk. Respons terhadap kueri untuk satu kuota biasanya sekitar 200 baris. Respons terhadap kueri untuk suatu produk dapat melebihi 2.000 baris.

Melihat dimensi untuk satu kuota atau batas sistem dengan gcloud

Untuk melihat dimensi untuk satu kuota atau batas sistem menggunakan gcloud CLI, jalankan perintah berikut di terminal Anda:

gcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID

Ganti kode berikut:

  • QUOTA_ID: ID untuk kuota atau batas sistem. Jika Anda tidak mengetahui ID kuota, pilih salah satu opsi berikut:

    1. Temukan dengan menggunakan konsol seperti yang dijelaskan dalam Menemukan ID kuota Anda.
    2. Lihat semua dimensi untuk produk yang terkait dengan kuota atau batas sistem yang Anda minati. Perintah ini tidak memerlukan ID kuota. Lihat bagian Melihat dimensi untuk produk dengan gcloud CLI.
  • PROJECT_ID: ID project Google Cloud Anda. Untuk menemukan project ID Anda, pilih salah satu opsi berikut:

    1. Untuk menemukan project ID menggunakan konsol, lihat Mengidentifikasi project.
    2. Jika Anda menetapkan project saat ini sebagai project default di konfigurasi gcloud CLI, temukan project ID Anda dengan menjalankan perintah gcloud berikut di terminal Anda:
      gcloud config get-value project
  • SERVICE_ID: ID layanan produk yang terkait dengan kuota atau batas sistem. Misalnya, jika kuota adalah untuk CPU A2 Compute Engine, ID layanan adalah compute.googleapis.com.

Melihat dimensi untuk produk dengan gcloud CLI

Untuk melihat dimensi untuk satu kuota atau batas sistem menggunakan gcloud CLI, jalankan perintah berikut di terminal Anda:

gcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda. Untuk menemukan project ID Anda, pilih salah satu opsi berikut:

    1. Untuk menemukan project ID menggunakan konsol, lihat Mengidentifikasi project.
    2. Jika Anda menetapkan project saat ini sebagai project default di konfigurasi gcloud CLI, temukan project ID Anda dengan menjalankan perintah gcloud berikut di terminal Anda:
      gcloud config get-value project
  • SERVICE_ID: ID layanan produk yang terkait dengan kuota atau batas sistem. Misalnya, jika kuota adalah untuk CPU A2 Compute Engine, ID layanan adalah compute.googleapis.com.

Prioritas dimensi

Beberapa kasus penggunaan untuk Cloud Quotas API memiliki penyiapan dimensi yang kompleks. Kuota dapat dikonfigurasi pada tingkat yang lebih terperinci daripada hanya region dan zona. Anda dapat mencapai perincian ini saat menggunakan dimensi khusus layanan. Misalnya, gpu_family dan network_id adalah dimensi khusus layanan di layanan Compute Engine. Dimensi ditentukan oleh setiap layanan dan setiap layanan mungkin memiliki serangkaian dimensi khusus layanan yang berbeda.

Saat menggunakan dimensi lokasi atau dimensi khusus layanan, urutan prioritas berikut diterapkan:

  1. Konfigurasi preferensi kuota dengan semua dimensi spesifik layanan dan lokasi yang ditentukan akan lebih diutamakan daripada konfigurasi lainnya.

  2. Konfigurasi yang menentukan dimensi lokasi saja lebih diutamakan daripada konfigurasi yang hanya berisi dimensi khusus layanan.

Menggabungkan dimensi

Dalam konfigurasi preferensi kuota, Anda dapat menggabungkan dimensi dengan cara berikut:

  1. Konfigurasi dapat berisi kedua dimensi lokasi dan dimensi khusus layanan. Ini adalah urutan tertinggi dalam prioritas.

  2. Konfigurasi hanya dapat berisi dimensi lokasi. Konfigurasi ini berlaku untuk semua dimensi khusus layanan, kecuali yang dikonfigurasi secara eksplisit dengan metode 1.

  3. Konfigurasi hanya dapat berisi dimensi khusus layanan. Konfigurasi ini berlaku untuk semua lokasi, kecuali yang dikonfigurasi secara eksplisit dengan metode 1 atau 2.

  4. Jika konfigurasi berisi dimensi khusus layanan, konfigurasi tersebut harus berisi semua dimensi khusus layanan.

  5. Anda dapat memiliki konfigurasi tanpa dimensi apa pun. Konfigurasi tersebut berlaku untuk semua lokasi dan semua dimensi khusus layanan, kecuali yang dikonfigurasi secara eksplisit.