Halaman ini diterjemahkan oleh Cloud Translation API.

Melihat kuota menggunakan gcloud alpha CLI

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 serta layanan Google Cloud.

Batasan

Kuota Cloud memiliki batasan berikut:

Semua penyesuaian peningkatan kuota tunduk pada persetujuan Google Cloud.
Anda dapat meminta penyesuaian peningkatan dan penurunan kuota untuk kuota level project.
Anda dapat meminta mengurangi penyesuaian kuota untuk kuota project-, folder-, dan tingkat organisasi.

Sebelum memulai

Sebelum memulai, pastikan Anda menginstal dan menginisialisasi gcloud CLI.

Anda mungkin juga memerlukan nilai QUOTA_ID. Jika ya, lihat petunjuk untuk menemukan QUOTA_ID.

Menginstal dan melakukan inisialisasi gcloud CLI.

Untuk menggunakan gcloud CLI, pastikan Anda telah menginstal dan melakukan inisialisasi versi terbaru gcloud CLI, termasuk komponen perintah alfa. Jika Anda menggunakan Cloud Shell untuk berinteraksi dengan Google Cloud, gcloud CLI akan diinstal untuk Anda.

Menemukan ID kuota

Banyak perintah gcloud CLI di halaman ini merujuk pada nilai ID kuota Anda.

Untuk menemukan nilai ID kuota, gunakan perintah gcloud CLI berikut untuk menampilkan daftar 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
```
Ganti kode berikut:
- SERVICE_NAME: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Cloud Logging adalah logging.googleapis.com
- PROJECT_ID_OR_NUMBER: project ID atau nomor project
  
  Untuk menemukan ID project Anda menggunakan konsol Google Cloud, buka halaman Resource Manager:
  
  Buka Resource Manager

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, lalu 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 menyediakan 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

Ganti kode berikut:

QUOTA_ID: ID kuota
SERVICE_NAME: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Cloud Logging adalah logging.googleapis.com
PROJECT_ID_OR_NUMBER: project ID atau nomor project

Melihat informasi kuota untuk organisasi

Untuk melihat detail kuota layanan yang sama untuk suatu organisasi, jalankan perintah berikut:

gcloud alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID

Ganti kode berikut:

SERVICE_NAME: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Cloud Logging adalah logging.googleapis.com
ORGANIZATION_ID: ID organisasi Anda

Contoh perintah preferensi kuota gcloud

Bagian ini menyediakan 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 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 alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER

Ganti PROJECT_ID_OR_NUMBER dengan project ID atau nomor project.

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

Ganti PROJECT_ID_OR_NUMBER dengan project ID atau nomor project.

Meminta penyesuaian peningkatan kuota untuk region tertentu jika preferensi kuota belum ditetapkan

Untuk meminta penyesuaian penambahan kuota untuk region 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 --preference-id=PREFERENCE_ID

Ganti kode berikut:

PREFERRED_VALUE: nilai kuota pilihan
QUOTA_ID: ID kuota
SERVICE_NAME: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Cloud Logging adalah logging.googleapis.com
PROJECT_ID_OR_NUMBER: project ID atau nomor project
PREFERENCE_ID: ID preferensi

Meminta penyesuaian peningkatan kuota untuk region tertentu saat preferensi kuota telah ditetapkan

Untuk meminta penyesuaian peningkatan kuota untuk region tertentu dan sudah ada preferensi, jalankan kembali 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

Ganti kode berikut:

PREFERENCE_ID: ID preferensi
PREFERRED_VALUE</var>"}}: nilai kuota pilihan
QUOTA_ID: ID kuota
SERVICE_NAME: nama layanan dengan kuota yang ingin Anda lihat—misalnya, nama layanan untuk Cloud Logging adalah logging.googleapis.com
PROJECT_ID_OR_NUMBER: project ID atau nomor project

Mengambil preferensi kuota yang ada

Untuk mengambil preferensi kuota yang ada, jalankan perintah berikut:

gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER

Ganti kode berikut:

PREFERENCE_ID: ID preferensi
PROJECT_ID_OR_NUMBER: project ID atau nomor project

Layanan lain dengan perintah gcloud CLI terkait kuota

Selain gcloud alpha quotas, beberapa layanan memiliki akses command line-nya 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 mengetahui daftar lengkap perintah dan flag gcloud alpha quotas, lihat bagian gcloud alpha paywall dalam referensi Google Cloud CLI.

Untuk mengetahui informasi selengkapnya tentang terminologi kuota, lihat Memahami nilai kuota dan batas sistem.