Cloud Quotas API mewakili dimensi sebagai key-value pair. key adalah nama dimensi (misalnya, region). value adalah nilai yang ditetapkan untuk dimensi (misalnya, region seperti us-central1). Kunci dan nilai bersifat peka huruf besar/kecil.
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 Cloud de Confiance by S3NS Anda.
Melihat dimensi
Anda dapat melihat dimensi untuk kuota dan batas sistem dengan melihat di Cloud de Confiance konsol, 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 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
Di Cloud de Confiance konsol, buka halaman IAM & Admin > Quotas & System Limits:
Tabel di halaman ini menampilkan dimensi di kolom Dimensions.
Jika Anda tidak melihat kolom Dimensions, lakukan langkah-langkah berikut. Jika tidak, lewati langkah ini.
- Klik Column display options.
- Pilih Dimensions.
- Klik OK. Kolom Dimensions akan muncul di tabel.
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 Dimensions 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 sebagai referensi. Karena nilai default berlaku untuk semua nilai dimensi, kolom Dimensions kosong. Lihat kolom Name untuk mengidentifikasi entri ini. Kolom Name menunjukkan entri ini dengan kata "default" dalam tanda kurung di akhir nama kuota atau batas sistem.
Misalnya, kuota
SetIamPolicyRequestsPerMinutePerProjectditentukan pada dimensiregion. Konsol menampilkan entri referensi, dan entri untuk setiap region. Di kolom Name, entri referensi tercantum sebagai "SetIAMPolicy requests per minute per region (default)". Untuk entri ini, kolom Dimensions kosong.Tidak ada dimensi yang berlaku. Misalnya, kuota Compute Engine
NETWORKS-per-projecttidak terkait dengan atribut region, zona, atau produk, 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 produk. Respons terhadap kueri untuk satu kuota biasanya sekitar 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 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:- Temukan dengan menggunakan konsol seperti yang dijelaskan dalam Menemukan ID kuota Anda.
- 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 Anda. Cloud de ConfianceUntuk menemukan project ID Anda, pilih salah satu opsi berikut:- Untuk menemukan project ID Anda menggunakan konsol, lihat Mengidentifikasi project.
- Jika Anda menetapkan project saat ini sebagai project default dalam 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 untuk CPU Compute Engine A2, ID layanannya adalahcompute.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 Anda. Cloud de ConfianceUntuk menemukan project ID Anda, pilih salah satu opsi berikut:- Untuk menemukan project ID Anda menggunakan konsol, lihat Mengidentifikasi project.
- Jika Anda menetapkan project saat ini sebagai project default dalam 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 untuk CPU Compute Engine A2, ID layanannya adalahcompute.googleapis.com.
Prioritas dimensi
Beberapa kasus penggunaan untuk Cloud Quotas API memiliki penyiapan dimensi yang kompleks.
Kuota dapat dikonfigurasi pada tingkat yang lebih mendetail daripada hanya region dan zona.
Anda dapat mencapai detail 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:
Konfigurasi preferensi kuota dengan semua dimensi lokasi dan khusus layanan yang ditentukan akan diprioritaskan daripada konfigurasi lainnya.
Konfigurasi yang hanya menentukan dimensi lokasi akan diprioritaskan daripada konfigurasi yang hanya berisi dimensi khusus layanan.
Menggabungkan dimensi
Dalam konfigurasi preferensi kuota, Anda dapat menggabungkan dimensi dengan cara berikut:
Konfigurasi dapat berisi dimensi lokasi dan dimensi khusus layanan. Ini adalah urutan tertinggi dalam prioritas.
Konfigurasi hanya dapat berisi dimensi lokasi. Konfigurasi ini berlaku untuk semua dimensi khusus layanan, kecuali yang dikonfigurasi secara eksplisit dengan metode 1.
Konfigurasi hanya dapat berisi dimensi khusus layanan. Konfigurasi ini berlaku untuk semua lokasi kecuali yang dikonfigurasi secara eksplisit dengan metode 1 atau 2.
Jika konfigurasi berisi dimensi khusus layanan apa pun, konfigurasi tersebut harus berisi semua dimensi khusus layanan.
Anda dapat memiliki konfigurasi tanpa dimensi apa pun. Konfigurasi tersebut berlaku untuk semua lokasi dan semua dimensi khusus layanan, kecuali yang dikonfigurasi secara eksplisit.