Mengonfigurasi dimensi Kuota Cloud

Dimensi Kuota Cloud mewakili berbagai cara untuk mengukur penggunaan resource di Google Cloud. Dimensi biasanya berupa atribut produk, pengguna Google Cloud, zona, atau region.

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

Misalnya, Compute Engine mengukur penggunaan VM 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 Google Cloud, menggunakan Google Cloud CLI, membuat kueri REST API, atau melalui library klien. 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.

console

1. Buka halaman Quotas & System Limits:

   Buka Kuota & Batasan Sistem

   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 Column display options.
   2. Pilih Dimensi.
   3. Klik Oke. Kolom Dimensi akan muncul di tabel.

3. Untuk memfilter hasil, masukkan nama atau nilai properti di kolom di samping filter_list Filter.

   • Untuk memfilter menurut produk, mulai masukkan nama produk, lalu 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 default atau batas sistem untuk referensi. Karena nilai 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 dicantumkan 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 region, zona, atau produk, sehingga tidak ada dimensi yang akan ditampilkan.

gcloud

Alfa — gcloud CLI for Cloud Quotas

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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 produk. Respons terhadap kueri untuk satu kuota biasanya berjumlah 200 baris. Respons terhadap kueri untuk 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 alpha 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.
  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 Anda 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 ditujukan untuk CPU A2 Compute Engine, ID layanannya 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 alpha 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 Anda 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 ditujukan untuk CPU A2 Compute Engine, ID layanannya 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 region dan zona saja. 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 individual dan setiap layanan mungkin memiliki kumpulan dimensi khusus layanan yang berbeda.

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

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

2. Konfigurasi yang menentukan dimensi lokasi hanya 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 baik dimensi lokasi maupun dimensi khusus layanan. Ini adalah urutan prioritas tertinggi.

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

3. Konfigurasi hanya boleh 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 apa pun, konfigurasi tersebut harus berisi semua dimensi khusus layanan.

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