Melihat dan mengelola kuota menggunakan gcloud alpha CLI

Alfa

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.

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:

1. Instal gcloud CLI.

   Jika menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah diinstal sebelumnya.

2. Lakukan inisialisasi gcloud CLI.

3. 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

1. Buka halaman Quotas & System Limits:

   Buka Kuota & Batasan Sistem

2. Klik filter_listFilter untuk memfilter layanan Anda.

3. Jika Anda tidak melihat kolom Limit name, klik ikon Column display options.... Pilih Limit name, lalu klik OK.

4. 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:

1. 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 adalah compute.googleapis.com

   • PROJECT_ID_OR_NUMBER: project ID atau nomor project

     Untuk menemukan project ID menggunakan konsol Google Cloud, buka halaman Resource Manager:

     Buka 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 dari 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.

2. 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"
                   ]
                   ...
               }
           ]
       },
       ...
   ]
   ...

3. Cari nilai yang sesuai dengan quotaId dan gunakan saat menentukan QUOTA_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 adalah compute.googleapis.com
• PROJECT_ID_OR_NUMBER: project ID atau nomor project

• 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 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 tersebut 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 adalah compute.googleapis.com
• ORGANIZATION_ID: ID organisasi Anda

• 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 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 tersebut 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 project

• 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 preferensi kuotanya Anda periksa.

  Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian tersebut 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 project

• 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 preferensi kuotanya Anda periksa.

  Jika Anda sudah menetapkan project penagihan saat menyiapkan gcloud CLI, tanda ini bersifat opsional. Jika tidak, pengecualian tersebut 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 \
    --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Ganti kode berikut:

• PREFERRED_VALUE: nilai kuota pilihan
• 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 adalah compute.googleapis.com
• PROJECT_ID_OR_NUMBER: project ID atau nomor project

• 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 sebelum kuota tambahan dapat diberikan

• JUSTIFICATION: string opsional yang menjelaskan permintaan Anda

• PREFERENCE_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 \
    --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 perintah gcloud alpha quotas preferences update
• PREFERRED_VALUE: nilai kuota pilihan
• 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 adalah compute.googleapis.com
• PROJECT_ID_OR_NUMBER: project ID atau nomor project

• 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 sebelum kuota tambahan dapat diberikan

• JUSTIFICATION: string opsional yang menjelaskan permintaan Anda

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 pilihan
• 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 adalah compute.googleapis.com
• PROJECT_ID_OR_NUMBER: project ID atau nomor project
• KEY1=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 tersebut 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 sebelum kuota tambahan dapat diberikan

• JUSTIFICATION: string opsional yang menjelaskan permintaan Anda

• PREFERENCE_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 perintah gcloud alpha quotas preferences describe
• PROJECT_ID_OR_NUMBER: project ID atau nomor project

• 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. 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 tersebut 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.