Bagian berikut berisi contoh perintah
gcloud alpha quotas info
dan
gcloud alpha 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
Kuota Cloud memiliki batasan berikut:
Penyesuaian peningkatan kuota harus dilakukan di tingkat project dan tunduk pada persetujuan Google Cloud.
Anda dapat meminta penyesuaian pengurangan kuota untuk kuota project-, folder-, dan tingkat organisasi.
Cloud Quotas API hanya mendukung operasi tingkat project. Operasi tingkat folder dan tingkat organisasi tidak didukung.
Sebelum memulai
Sebelum menggunakan gcloud CLI, pastikan Anda menginstal dan melakukan inisialisasi gcloud CLI.
Anda mungkin juga memerlukan nilai QUOTA_ID
. 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 menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah diinstal sebelumnya.
Lakukan inisialisasi gcloud CLI.
Instal komponen alfa dengan menjalankan perintah berikut:
gcloud components install alpha
Menemukan ID kuota
Beberapa perintah gcloud CLI di halaman ini merujuk ke 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
Buka halaman Quotas & System Limits:
Klik
Filter untuk memfilter layanan Anda.Jika Anda tidak melihat kolom Limit name, klik ikon
Column display options.... Pilih Limit name, 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 alpha 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 ID kuotanya Anda cari.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Output dari perintah
gcloud alpha 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 alpha 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 alpha 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.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 dari project yang berisi layanan yang info kuotanya Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini 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 alpha 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 dari project yang berisi layanan yang info kuotanya Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini 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 alpha quotas preferences
untuk memeriksa preferensi kuota yang ada dan menyesuaikan nilai kuota.
Resource QuotaPreference
mewakili preferensi Anda untuk kombinasi dimensi
tertentu. Dimensi adalah atribut yang mewakili wilayah
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 alpha 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 preferensi kuotanya Anda periksa.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini 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 alpha 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 preferensi kuotanya Anda periksa.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Meminta penyesuaian penambahan kuota jika preferensi kuota belum ditetapkan
Untuk meminta penyesuaian peningkatan kuota untuk wilayah tertentu jika preferensi belum ditetapkan, jalankan perintah berikut:
gcloud alpha 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 --preference-id=PREFERENCE_ID
Ganti kode berikut:
PREFERRED_VALUE
: nilai kuota pilihanQUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota.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, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud memerlukan informasi lebih lanjut untuk membuat keputusan sebelum kuota tambahan dapat diberikanPREFERENCE_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 peningkatan kuota untuk region tertentu dan sudah ada preferensi, jalankan perintah berikut:
gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--email=EMAIL --billing-project=BILLING_PROJECT_ID_OR_NUMBER
Ganti kode berikut:
PREFERENCE_ID
: ID preferensi, yang diperlukan sebagai argumen pertama saat menggunakan perintahgcloud alpha quotas preferences update
PREFERRED_VALUE
: nilai kuota pilihanQUOTA_ID
: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota.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 projectEMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud memerlukan informasi lebih lanjut untuk membuat keputusan sebelum kuota tambahan dapat diberikanBILLING_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, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Meminta penyesuaian penambahan kuota menggunakan dimensi
Untuk meminta penyesuaian penambahan kuota menggunakan dimensi, jalankan perintah berikut:
gcloud alpha 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.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 mungkin 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, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL
: alamat email yang dapat digunakan sebagai kontak, jika Google Cloud memerlukan informasi lebih lanjut untuk membuat keputusan 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 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 alpha 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 alpha 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. Hal ini dapat berbeda dengan project yang preferensi kuotanya Anda lihat.
Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian ini dapat menyebabkan error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
Output akan berisi data khusus untuk konfigurasi Anda dan 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'
Layanan lain dengan perintah gcloud CLI terkait kuota
Selain gcloud alpha 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 selanjutnya
Untuk memecahkan masalah terkait perintah
gcloud alpha quotas
, lihat Memecahkan masalah error gcloud CLI.Untuk mengetahui detail tentang perintah dan flag
gcloud alpha quotas
, lihat bagian kuota gcloud alpha dalam referensi Google Cloud CLI.Untuk mengetahui informasi selengkapnya tentang terminologi kuota, lihat Memahami nilai kuota dan batas sistem.