Bagian berikut berisi contoh perintah
gcloud beta quotas info
dan
gcloud beta quotas preferences
. Perintah ini memungkinkan Anda melihat dan mengelola resource QuotaInfo
dan
QuotaPreference
.
Anda dapat menggunakan Google Cloud CLI (gcloud CLI) untuk mendapatkan nilai kuota saat ini dan menentukan preferensi kuota untuk beberapa API dan layanan Google Cloud .
Batasan
Cloud Quotas memiliki batasan berikut:
Dalam sebagian besar kasus, penyesuaian peningkatan kuota harus dilakukan di tingkat project. Sejumlah produk terbatas mendukung penyesuaian peningkatan kuota tingkat organisasi. Untuk melihat apakah produk mendukung penyesuaian peningkatan kuota tingkat organisasi, lihat dokumentasi untuk produk tersebut. Google Cloud
Anda dapat meminta penyesuaian penurunan kuota untuk kuota tingkat project, organisasi, dan folder.
Sebelum memulai
Sebelum menggunakan gcloud CLI, pastikan Anda telah menginstal dan melakukan inisialisasi gcloud CLI.
Anda mungkin juga memerlukan nilai QUOTA_ID
Anda. Jika ya, lihat
petunjuk untuk menemukan ID kuota Anda.
Menginstal dan melakukan inisialisasi gcloud CLI.
Untuk menggunakan gcloud CLI untuk Kuota Cloud, pastikan untuk menginstal dan melakukan inisialisasi komponen:
Instal gcloud CLI.
Jika Anda menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah diinstal sebelumnya.
Lakukan inisialisasi gcloud CLI.
Instal komponen beta dengan menjalankan perintah berikut:
gcloud components install beta
Menemukan ID kuota Anda
Beberapa perintah gcloud CLI di halaman ini merujuk pada nilai ID kuota Anda. Anda dapat menemukan ID kuota menggunakan konsol Google Cloud , gcloud CLI, library klien, atau REST API. Bagian ini menunjukkan cara menemukan ID kuota menggunakan konsol Google Cloud atau gcloud CLI.
Konsol
Di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits:
Klik
Filter untuk memfilter layanan Anda.Jika Anda tidak melihat kolom Nama batas, klik ikon
Opsi tampilan kolom.... Pilih Nama batas, lalu klik OK.Kolom Nama batas menampilkan ID kuota.
gcloud
Untuk menemukan nilai ID kuota menggunakan gcloud CLI, jalankan perintah berikut untuk mencantumkan informasi kuota Anda untuk layanan yang ditentukan:
Masukkan perintah gcloud CLI berikut di jendela terminal:
gcloud beta quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \ --billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectUntuk menemukan project ID menggunakan konsol Google Cloud , buka halaman Resource Manager:
BILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang berisi layanan yang Anda cari ID kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Output dari perintah
gcloud beta quotas info list
berisi teks yang mirip dengan contoh berikut:... "quotaInfos": [ ... { "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region", "quotaId": "CPUS-per-project-region", "metric": "compute.googleapis.com/cpus", "containerType": "PROJECT", "dimensions": [ "region" ], "dimensionsInfo": [ { "details": { "value": 20 }, "applicableLocations": [ "us-central1", "us-central2", "us-west1", "us-east1" ] ... } ] }, ... ] ...
Cari nilai yang sesuai dengan
quotaId
dan gunakan saat menentukanQUOTA_ID
di bagian berikut.
Contoh perintah informasi kuota gcloud
Bagian ini memberikan contoh yang menunjukkan cara menggunakan perintah gcloud beta quotas info
untuk melihat informasi kuota untuk layanan tertentu atau untuk
organisasi.
QuotaInfo
adalah resource hanya baca yang memberikan informasi metadata dan nilai kuota tentang kuota tertentu untuk project, folder, atau organisasi tertentu.
Melihat informasi kuota untuk layanan tertentu
Untuk melihat informasi kuota layanan tertentu, jalankan perintah berikut:
gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
--project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
QUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota Anda.SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang berisi layanan yang kuotanya ingin Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Melihat informasi kuota untuk organisasi
Untuk melihat detail kuota layanan yang sama untuk organisasi, jalankan perintah berikut:
gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
ORGANIZATION_ID
: ID organisasi AndaBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang berisi layanan yang kuotanya ingin Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Contoh perintah preferensi kuota gcloud
Bagian ini memberikan contoh yang menunjukkan cara menggunakan perintah gcloud beta quotas preferences
untuk memeriksa preferensi kuota yang ada dan menyesuaikan nilai kuota.
Resource QuotaPreference
merepresentasikan preferensi Anda untuk kombinasi
dimensi tertentu. Dimensi adalah atribut yang merepresentasikan region
atau zona, atau dimensi khusus layanan, seperti gpu_family
atau network_id
.
Memeriksa preferensi yang ada
Untuk memeriksa preferensi yang ada, jalankan perintah berikut:
gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang Anda periksa preferensi kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Memeriksa preferensi yang ada dengan penyesuaian kuota yang tertunda
Untuk memeriksa preferensi yang ada dengan penyesuaian kuota yang tertunda, tambahkan flag
--reconciling-only=true
seperti yang ditunjukkan dalam perintah berikut:
gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang Anda periksa preferensi kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Meminta penyesuaian penambahan kuota saat preferensi kuota belum ditetapkan
Untuk meminta penyesuaian peningkatan kuota untuk wilayah tertentu saat preferensi belum ditetapkan, jalankan perintah berikut:
gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL \
--justification=JUSTIFICATION --preference-id=PREFERENCE_ID
Ganti kode berikut:
PREFERRED_VALUE
: nilai kuota pilihanQUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota Anda.SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang Anda minta penyesuaian kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud membutuhkan informasi lebih lanjut sebelum kuota tambahan dapat diberikanJUSTIFICATION
: string opsional yang menjelaskan permintaan AndaPREFERENCE_ID
: ID preferensi opsional; jika Anda tidak menentukan ID preferensi, API akan membuat ID Unik Universal (UUID) untuk Anda
Meminta penyesuaian penambahan kuota saat preferensi kuota telah ditetapkan
Untuk meminta penyesuaian penambahan kuota untuk region tertentu dan sudah ada preferensi, jalankan perintah berikut:
gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL \
--justification=JUSTIFICATION
Ganti kode berikut:
PREFERENCE_ID
: ID preferensi, yang diperlukan sebagai argumen pertama saat menggunakan perintahgcloud beta quotas preferences update
PREFERRED_VALUE
: nilai kuota pilihanQUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota Anda.SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang Anda minta penyesuaian kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud membutuhkan informasi lebih lanjut sebelum kuota tambahan dapat diberikanJUSTIFICATION
: string opsional yang menjelaskan permintaan Anda
Meminta penyesuaian penambahan kuota menggunakan dimensi
Untuk meminta penyesuaian penambahan kuota menggunakan dimensi, jalankan perintah berikut:
gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
--email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID
Ganti kode berikut:
PREFERRED_VALUE
: nilai kuota pilihanQUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota Anda.SERVICE_NAME
: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Compute Engine adalahcompute.googleapis.com
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectKEY1=VALUE1,KEY2=VALUE2,...
: daftar opsional yang menentukan dimensi Anda sebagai daftar pasangan nilai kunci yang dipisahkan koma. Misalnya, dimensi Anda dapat menentukan nilai Compute Engine berikut:KEY1=VALUE1
:region=us-east4
KEY2=VALUE2
:gpu_family=NVIDIA_H100
BILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang Anda minta penyesuaian kuotanya.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud membutuhkan informasi lebih lanjut sebelum kuota tambahan dapat diberikanJUSTIFICATION
: string opsional yang menjelaskan permintaan AndaPREFERENCE_ID
: ID preferensi opsional; jika Anda tidak menentukan ID preferensi, API akan membuat ID Unik Universal (UUID) untuk Anda
Output akan berisi data khusus untuk konfigurasi Anda dan akan terlihat mirip dengan contoh output berikut:
{
"createTime":"CREATE_TIME",
"dimensions":{
"gpu_family":"NVIDIA_H100",
"region":"us-east4"
},
"etag":"ETAG_VALUE",
"name":"projects/12345/locations/global/quotaPreferences/PREFERENCE_ID",
"quotaConfig":{
"grantedValue":"0",
"preferredValue":"128",
"traceId":"TRACE_ID"
},
"quotaId":"GPUS-PER-GPU-FAMILY-per-project-region",
"reconciling":true,
"service":"compute.googleapis.com",
"updateTime":"UPDATE_TIME",
}
Melihat preferensi kuota yang ada
Untuk melihat detail preferensi kuota yang baru saja Anda buat, jalankan perintah berikut:
gcloud beta quotas preferences describe PREFERENCE_ID \
--project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
PREFERENCE_ID
: ID preferensi, yang diperlukan sebagai argumen pertama saat menggunakan perintahgcloud beta quotas preferences describe
PROJECT_ID_OR_NUMBER
: project ID atau nomor projectBILLING_PROJECT_ID_OR_NUMBER
: project ID atau nomor project untuk penggunaan kuota dan penagihan. Menjalankan perintah gcloud akan memengaruhi kuota seolah-olah Anda membuat permintaan yang setara secara langsung melalui REST atau RPC API.Tentukan project yang kuotanya ingin Anda gunakan. Project ini dapat berbeda dengan project yang kuota preferensinya Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, menghilangkannya dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Output akan berisi data khusus untuk konfigurasi Anda dan akan terlihat mirip dengan contoh output berikut:
createTime: 'CREATE_TIME'
dimensions:
gpu_family: NVIDIA_H100
region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
grantedValue: '0'
preferredValue: '128'
traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'
Mengaktifkan pengatur kuota melalui project klien
Project klien mengacu pada project yang digunakan oleh aplikasi atau pengguna untuk mengakses dan berinteraksi dengan Google Cloud resource, sedangkan project resource adalah project pokok tempat resource tersebut disimpan dan dikelola.
Untuk mengaktifkan pengatur kuota melalui project klien menggunakan gcloud CLI, ikuti langkah-langkah berikut:
Membuat project klien:
gcloud projects create CLIENT_PROJECT_ID gcloud config set project CLIENT_PROJECT_ID
Ganti
CLIENT_PROJECT_ID
dengan ID project yang ingin Anda buat. Project ID tidak dapat diubah dan hanya dapat disetel selama pembuatan project. Nama ini harus dimulai dengan huruf kecil dan dapat berisi huruf ASCII kecil, angka, atau tanda hubung. ID project harus terdiri dari 6 hingga 30 karakter.Aktifkan Cloud Quotas API di project klien:
gcloud services enable cloudquotas.googleapis.com
Buat akun layanan di project klien:
gcloud iam service-accounts create SA_NAME \ --display-name SA_DISPLAY_NAME \ --project=CLIENT_PROJECT_ID
Ganti kode berikut:
SA_NAME
: nama internal akun layanan baru. Digunakan untuk membuat IAM_ACCOUNT (alamat email internal IAM yang digunakan sebagai ID akun layanan), yang harus diteruskan ke perintah berikutnya.SA_DISPLAY_NAME
: nama tampilan akun layanan.CLIENT_PROJECT_ID
: ID project klien.
Buat kunci akun layanan:
gcloud iam service-accounts keys create KEY_FILE \ --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
Ganti kode berikut:
KEY_FILE
: jalur ke file kunci akun layanan JSON.SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
: alamat email akun layanan.
Memberikan izin IAM ke akun layanan:
gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \ --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/serviceusage.serviceUsageConsumer" gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \ --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/cloudquotas.admin"
Ganti kode berikut:
CLIENT_PROJECT_ID
: ID project klien.RESOURCE_PROJECT_ID
: ID project resource.SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
: alamat email akun layanan.
Aktifkan akun layanan menggunakan kunci akun layanan yang Anda buat sebelumnya:
gcloud auth activate-service-account --key-file=KEY_FILE
Aktifkan pengatur kuota di project resource Anda dengan menentukan project dan setelan pengaktifan:
gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \ --enablement=enabled
Setelan pengaktifan diperlukan saat menggunakan gcloud CLI dan harus ditetapkan ke
enabled
ataudisabled
.Opsional: Untuk melihat setelan penyesu kuota saat ini, jalankan perintah berikut:
gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID
Outputnya mirip dengan contoh berikut:
enablement: ENABLED etag: 8izmJp6EI__mOfLyhkQU9 name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings updateTime: '2025-01-10T17:22:37.883221181Z'
Untuk mengaktifkan pengatur kuota untuk beberapa project klien, ikuti langkah-langkah 5 hingga 8 sebelumnya. Saat melakukannya, pastikan kondisi berikut terpenuhi:
- Cloud Quotas API diaktifkan di project klien.
- Pastikan akun layanan memiliki peran IAM
cloudquotas.admin
di semua project resource yang ingin Anda aktifkan penyesuai kuotanya.
Layanan lain dengan perintah gcloud CLI terkait kuota
Selain gcloud beta quotas
, beberapa layanan memiliki akses command line sendiri ke informasi kuota dan penggunaan resource.
Misalnya, Compute Engine memungkinkan Anda mengakses informasi kuota. Untuk mengetahui detailnya, lihat bagian Compute Engine berikut:
- Kuota alokasi
- Ringkasan komputasi gcloud CLI
- Bagian gcloud CLI compute dari referensi Google Cloud SDK.
Langkah berikutnya
Untuk memecahkan masalah perintah
gcloud beta quotas
, lihat Memecahkan masalah error gcloud CLI.Untuk mengetahui detail tentang perintah dan flag
gcloud beta quotas
, lihat bagian kuota gcloud beta dalam referensi Google Cloud CLI.Untuk mengetahui informasi selengkapnya tentang terminologi kuota, lihat Memahami nilai kuota dan batas sistem.