Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengelola kuota menggunakan gcloud CLI

Bagian berikut berisi contoh gcloud quotas info dan gcloud quotas preferences perintah. 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 Google Cloud API dan layanan.

Batasan

Kuota Cloud memiliki batasan berikut:

Dalam sebagian besar kasus, penyesuaian peningkatan kuota harus dilakukan di tingkat project. Hanya sejumlah kecil produk yang mendukung penyesuaian peningkatan kuota tingkat organisasi. Untuk melihat apakah Google Cloud produk mendukung penyesuaian peningkatan kuota tingkat organisasi, lihat dokumentasi untuk produk tersebut.
Anda dapat meminta penyesuaian penurunan kuota untuk kuota tingkat project, organisasi, dan folder.

Sebelum memulai

Sebelum menggunakan gcloud CLI, pastikan Anda menginstal dan menginisialisasi gcloud CLI.

Anda mungkin juga memerlukan nilai QUOTA_ID. Jika demikian, lihat petunjuk untuk menemukan ID kuota Anda.

Menginstal dan melakukan inisialisasi gcloud CLI.

Untuk menggunakan gcloud CLI untuk Kuota Cloud, pastikan Anda menginstal dan menginisialisasi komponen:

Instal gcloud CLI.

Jika menggunakan Cloud Shell, Anda dapat melewati langkah ini karena gcloud CLI sudah terinstal.
Lakukan inisialisasi gcloud CLI.
Instal komponen beta dengan menjalankan perintah berikut:
```
gcloud components install beta
```

Menemukan ID kuota Anda

Beberapa perintah gcloud CLI dalam dokumen ini merujuk ke nilai ID kuota Anda. Anda dapat menemukan ID kuota menggunakan Google Cloud konsol, gcloud CLI, library klien, atau REST API. Bagian ini menunjukkan cara menemukan ID kuota menggunakan konsol atau gcloud CLI. Google Cloud

Konsol

Di Google Cloud konsol, buka halaman IAM & Admin > Quotas & System Limits:
Buka 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 Limit name 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 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 Anda menggunakan Google Cloud konsol, buka halaman Resource Manager:
  Buka Resource Manager
- BILLING_PROJECT_ID_OR_NUMBER: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang ID kuotanya Anda temukan.
  
  Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.

Output dari perintah gcloud 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 menentukan QUOTA_ID di bagian berikut.

Contoh perintah informasi kuota gcloud

Bagian ini memberikan contoh yang menunjukkan cara menggunakan perintah gcloud quotas info untuk melihat informasi kuota untuk layanan tertentu atau untuk organisasi.

QuotaInfo adalah resource hanya baca yang menyediakan metadata dan informasi nilai kuota tentang kuota tertentu untuk project, folder, atau organisasi tertentu.

Melihat informasi kuota untuk layanan tertentu

Untuk melihat informasi kuota untuk layanan tertentu, jalankan perintah berikut:

gcloud 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 adalah compute.googleapis.com.
PROJECT_ID_OR_NUMBER: project ID atau nomor project.
BILLING_PROJECT_ID_OR_NUMBER: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang informasi kuotanya Anda lihat.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a 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 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: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang informasi kuotanya Anda lihat.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a 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 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 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 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: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang preferensi kuotanya Anda periksa.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a 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 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: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang preferensi kuotanya Anda periksa.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.

Meminta penyesuaian peningkatan kuota jika preferensi kuota belum ditetapkan

Untuk meminta penyesuaian kuota menggunakan gcloud CLI, jalankan perintah berikut:

gcloud quotas preferences create --project=PROJECT_ID_OR_NUMBER \
    --service=SERVICE_NAME \
    --quota-id=QUOTA_ID \
    --dimensions=DIMENSIONS \
    --preferred-value=PREFERRED_VALUE \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL \
    --justification=JUSTIFICATION \
    --preference-id=PREFERENCE_ID

Ganti kode berikut:

PROJECT_ID_OR_NUMBER: project ID atau nomor project.
SERVICE_NAME: nama layanan dengan kuota yang ingin Anda sesuaikan—misalnya, nama layanan untuk Compute Engine adalah compute.googleapis.com.
QUOTA_ID: nilai ID kuota. Untuk menemukan nilai ini, lihat Menemukan ID kuota Anda.
DIMENSIONS: dimensi yang akan disesuaikan, yang ditentukan sebagai daftar pasangan nilai kunci yang dipisahkan koma—misalnya, region=us-east4,gpu_family=NVIDIA_H100. Untuk mengetahui informasi selengkapnya tentang dimensi kuota, lihat Mengonfigurasi dimensi Kuota Cloud.
PREFERRED_VALUE: nilai kuota pilihan.
BILLING_PROJECT_ID_OR_NUMBER: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang penyesuaian kuotanya Anda minta.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a 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.

Outputnya akan terlihat mirip seperti berikut:

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "DIMENSION_KEY_1":"DIMENSION_VALUE_1",
        "DIMENSION_KEY_2":"DIMENSION_VALUE_2"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/PROJECT_ID_OR_NUMBER/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"GRANTED_VALUE",
        "preferredValue":"PREFERRED_VALUE",
        "traceId":"TRACE_ID"
    },
    "quotaId":"QUOTA_ID",
    "reconciling":true,
    "service":"SERVICE_NAME",
    "updateTime":"UPDATE_TIME",
}

Meminta penyesuaian peningkatan kuota jika preferensi kuota telah ditetapkan

Untuk meminta penyesuaian peningkatan kuota untuk region tertentu dan jika sudah ada preferensi, jalankan perintah berikut:

gcloud 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 quotas preferences update.
PREFERRED_VALUE: nilai kuota pilihan.
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 adalah compute.googleapis.com.
PROJECT_ID_OR_NUMBER: project ID atau nomor project.
BILLING_PROJECT_ID_OR_NUMBER: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang penyesuaian kuotanya Anda minta.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a error izin ditolak. Untuk mengetahui informasi selengkapnya, lihat Menetapkan project kuota.
EMAIL: alamat email yang dapat digunakan sebagai kontak, jika memerlukan informasi lebih lanjut sebelum kuota tambahan dapat diberikan. Google Cloud
JUSTIFICATION: string opsional yang menjelaskan permintaan Anda.

Melihat preferensi kuota yang ada

Untuk melihat detail preferensi kuota yang baru saja Anda buat, jalankan perintah berikut:

gcloud 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 quotas preferences describe.
PROJECT_ID_OR_NUMBER: project ID atau nomor project.
BILLING_PROJECT_ID_OR_NUMBER: ID atau nomor project dari project yang kuota Cloud Quotas API-nya ingin Anda gunakan untuk menjalankan perintah ini. Project ini dapat berbeda dengan project yang berisi layanan yang preferensi kuotanya Anda lihat.

Jika Anda telah menetapkan project penagihan saat menyiapkan gcloud CLI, flag ini bersifat opsional. Jika tidak, menghapusnya dapat menyebabkan a 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 yang mendasarinya tempat resource tersebut disimpan dan dikelola.

Untuk mengaktifkan pengatur kuota melalui project klien menggunakan gcloud CLI, ikuti langkah-langkah berikut:

Buat project klien:
```
gcloud projects create CLIENT_PROJECT_ID
gcloud config set project CLIENT_PROJECT_ID
```
Ganti CLIENT_PROJECT_ID dengan ID untuk project yang ingin Anda buat. Project ID tidak dapat diubah dan hanya dapat ditetapkan selama pembuatan project. Project ID harus diawali dengan huruf kecil dan dapat memiliki huruf ASCII kecil, angka, atau tanda hubung. Project ID 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.

Berikan 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 quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
  --enablement=enabled
```
Setelan pengaktifan diperlukan saat menggunakan gcloud CLI dan harus ditetapkan ke enabled atau disabled.

Opsional: Untuk melihat setelan pengatur kuota saat ini, jalankan perintah berikut:

gcloud 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 sebelumnya 5 hingga 8. Saat melakukannya, pastikan kondisi berikut terpenuhi:

Cloud Quotas API diaktifkan di project klien.
Akun layanan memiliki peran IAM cloudquotas.admin di semua project resource yang pengatur kuotanya ingin Anda aktifkan.

Layanan lain dengan perintah gcloud CLI terkait kuota

Selain gcloud 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 komputasi gcloud CLI dari referensi Google Cloud SDK

Langkah berikutnya

Untuk memecahkan masalah dengan gcloud quotas perintah, lihat Memecahkan masalah error gcloud CLI.
Untuk mengetahui detail tentang perintah dan flag gcloud quotas, lihat bagian gcloud quotas dari referensi Google Cloud CLI.
Untuk mengetahui informasi selengkapnya tentang terminologi kuota, lihat Memahami terminologi kuota dan batas sistem.

Mengelola kuota menggunakan gcloud CLI Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Batasan

Sebelum memulai

Menginstal dan melakukan inisialisasi gcloud CLI.

Menemukan ID kuota Anda

Konsol

gcloud

Contoh perintah informasi kuota gcloud

Melihat informasi kuota untuk layanan tertentu

Melihat informasi kuota untuk organisasi

Contoh perintah preferensi kuota gcloud

Memeriksa preferensi yang ada

Memeriksa preferensi yang ada dengan penyesuaian kuota yang tertunda

Meminta penyesuaian peningkatan kuota jika preferensi kuota belum ditetapkan

Meminta penyesuaian peningkatan kuota jika preferensi kuota telah ditetapkan

Melihat preferensi kuota yang ada

Mengaktifkan pengatur kuota melalui project klien

Layanan lain dengan perintah gcloud CLI terkait kuota

Langkah berikutnya

Mengelola kuota menggunakan gcloud CLI