Kuota operasi serentak Compute Engine

---

Dokumen ini menjelaskan kuota operasi serentak untuk Compute Engine.

Kuota operasi serentak

Kuota operasi serentak menentukan jumlah operasi yang sedang berlangsung atau secara serentak yang dapat terjadi kapan saja. Setiap permintaan API yang membuat, mengubah, atau menghapus resource Compute Engine tunduk kepada pemeriksaan batas operasi serentak untuk memastikan bahwa jumlah total operasi yang sedang berlangsung pada setiap titik waktu tidak melebihi batas yang ditentukan untuk operasi tersebut.

Error batas operasi serentak terlampaui

Jika project Anda melebihi batas operasi serentak untuk operasi yang sedang berlangsung, Anda akan menerima error 403 dengan alasan rateLimitExceeded.

Respons API error terlihat mirip dengan yang berikut ini:

    "error": {
      "code": 403,
      "message": "Rate Limit Exceeded",
      "errors": [
        {
          "message": "Rate Limit Exceeded",
          "domain": "usageLimits",
          "reason": "rateLimitExceeded",
        ...
        ...
        }
      ],
      "details": [
        {
          "@type": "type.googleapis.com/google.rpc.ErrorInfo",
          "reason": "CONCURRENT_OPERATIONS_QUOTA_EXCEEDED",
          "domain": "compute.googleapis.com",
          "metadatas": {
            "containerType": "PROJECT",
            "containerId": "PROJECT_ID",
            "quotaMetric": "QUOTA_METRIC",
            "quotaLimit": "QUOTA_LIMIT",
            "operationType": "OPERATION_TYPE",
            "location": "global | REGION"
          }
        },
        {
          "@type": "type.googleapis.com/google.rpc.Help",
          "links": [
            {
              "description": "Concurrent operations quota documentation.",
              "url": "https://cloud.google.com/compute/operations-quota#concurrent_operation_limits"
            }
          ]
        },
      ...
      ... 

Detail error berisi nilai-nilai berikut:

• PROJECT_ID: ID project saat kuota melebihi batas.

• QUOTA_METRIC: metrik untuk kuota serentak yang melebihi batas. Nilainya bisa berupa salah satu hal berikut:

  • compute.googleapis.com/global_concurrent_operations
  • compute.googleapis.com/regional_concurrent_operations

• QUOTA_LIMIT: nama batas kuota serentak. Nilainya bisa berupa salah satu hal berikut:

  • GlobalConcurrentOperationsPerProject
  • GlobalConcurrentOperationsPerProjectOperationType
  • RegionalConcurrentOperationsPerProject
  • RegionalConcurrentOperationsPerProjectOperationType

• OPERATION_TYPE: operasi global atau regional yang kuotanya melebihi batas. Untuk daftar operasi, lihat Grup kuota operasi serentak.

• location dapat berupa salah satu dari hal berikut:

  • global: menentukan bahwa batas kuota operasi global terlampaui
  • REGION: menentukan region dengan batas kuota operasi terlampaui

Lihat penggunaan dan batas kuota operasi serentak serta baca praktik terbaik untuk mengurangi error kuota ini.

Grup kuota operasi serentak

Bagian ini menjelaskan batas untuk berbagai operasi Compute Engine yang sedang berlangsung atau serentak.

Kuota operasi global

Operasi global serentak menggunakan batas global yang ditentukan untuk jenis operasi per project. Tabel berikut mencantumkan kuota global untuk operasi yang sedang berlangsung dan metrik yang sesuai.

Anda dapat melihat kuota untuk operasi global menggunakan Konsol Google Cloud, Google Cloud CLI, dan Service Usage API. Untuk informasi selengkapnya, baca Melihat kuota dan batas operasi serentak.

Nama kuota Deskripsi	Nama metrik	Metode yang menggunakan kuota ini
Concurrent global operations per project Membatasi jumlah total operasi global serentak untuk suatu project. Lihat kuota ini di konsol Google Cloud	compute.googleapis.com/global_concurrent_operations	Semua metode global. URL permintaan HTTP berisi global untuk metode ini. Misalnya, metode networks.insert: POST /compute/v1/projects/{project}/global/networks
Concurrent global operations per project operation type Membatasi jumlah operasi serentak per project per jenis operasi. Lihat kuota ini di konsol Google Cloud	compute.googleapis.com/global_concurrent_operations	Semua metode global. Kuota operasi serentak default adalah 500 operasi yang sedang berlangsung per project, kecuali untuk metode berikut, yang memiliki batas default yang berbeda: globaladdresses.move firewalls.delete firewalls.insert images.delete images.deprecate images.insert images.patch images.setLabels images.setIamPolicy licenses.insert machineimages.delete machineimages.insert networks.addPeering networks.removePeering networks.updatePeering projects.setCommonInstaneMetadata publicAdvertisedPrefixes.delete publicAdvertisedPrefixes.insert routes.delete routes.insert securityPolicies.patchRule snapshots.delete snapshots.insert snapshots.setLabels snapshots.setIamPolicy snapshotSettings.patch

Kuota operasi regional

Operasi regional serentak menggunakan batas regional yang ditentukan untuk jenis operasi per project di region tertentu.

Tabel berikut mencantumkan kuota regional untuk operasi yang sedang berlangsung dan metrik yang sesuai.

Anda dapat melihat kuota untuk operasi regional menggunakan Google Cloud Console, Google Cloud CLI, dan Service Usage API. Untuk informasi selengkapnya, baca Melihat kuota dan batas operasi serentak.

Nama kuota Deskripsi	Nama metrik	Metode yang menggunakan kuota ini
Concurrent regional operations per project Membatasi jumlah total operasi regional serentak untuk suatu project. Lihat kuota ini di konsol Google Cloud	compute.googleapis.com/regional_concurrent_operations	Semua metode regional. URL permintaan HTTP berisi regions atau zones untuk metode ini. Misalnya, metode instances.insert: POST /compute/v1/projects/{project}/zones/{zone}/instances
Concurrent regional operations per project operation type Membatasi jumlah operasi regional serentak per project per jenis operasi. Lihat kuota ini di konsol Google Cloud	compute.googleapis.com/regional_concurrent_operations	Semua metode regional. Kuota operasi serentak default adalah 500 operasi yang sedang berlangsung per project per region, kecuali untuk metode berikut, yang memiliki batas default berbeda: addresses.move disks.insert instances.delete instances.insert instances.simulateMaintenanceEvent networkEndpointGroups.attachNetworkEndpoints networkEndpointGroups.detachNetworkEndpoints publicDelegatedPrefixes.delete publicDelegatedPrefixes.insert

Melihat kuota dan batas operasi serentak

Untuk melihat penggunaan dan batas kuota dalam sebuah project, lakukan langkah berikut:

Konsol

1. Di Konsol Google Cloud, buka halaman Quotas.

   Buka Quotas

   Halaman Quotas mencantumkan semua penggunaan dan batas kuota untuk project Anda. Secara default, daftar diurutkan untuk menampilkan kuota yang paling sering Anda gunakan terlebih dahulu, yang membantu Anda melihat batas yang berisiko terlampaui.

2. Untuk memfilter daftar dan melihat penggunaan serta batas kuota tertentu, pilih Quota atau Metric di kolom Filter.

   Misalnya, pilih Kuota Concurrent global operations per project operation type untuk melihat penggunaan kuota untuk metode global per jenis operasi.

   Untuk memfilter kuota operasi tertentu, tambahkan Dimensi ke kueri filter, lalu pilih operation_type. Misalnya, pilih firewalls_insert untuk melihat penggunaan dan batas kuota untuk operasi firewalls.insert.

gcloud

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menggunakan Google Cloud CLI untuk melihat penggunaan dan batas kuota operasi serentak.

Untuk menggunakan pendekatan ini, pastikan Anda telah menginstal komponen perintah alfa. Jika Anda menggunakan Cloud Shell untuk berinteraksi dengan Google Cloud, Google Cloud CLI akan diinstal untuk Anda.

Untuk melihat kuota, gunakan perintah berikut:

gcloud alpha services quota list \
    --service=compute.googleapis.com \
    --consumer=projects/PROJECT_ID

Ganti PROJECT_ID dengan ID project yang ingin Anda lihat kuotanya.

Praktik terbaik

Checklist berikut merangkum praktik terbaik untuk mengurangi error batas operasi serentak yang tidak memadai:

• Menunggu operasi selesai
• Mengandalkan kode error, bukan pesan error
• Meminimalkan percobaan ulang sisi klien untuk mempertahankan batas kapasitas API
  • Menghindari polling singkat
  • Menggunakan bursting dengan hemat dan selektif
  • Selalu melakukan panggilan dalam loop percobaan ulang dengan backoff eksponensial
  • Menggunakan pembatas kapasitas sisi klien
  • Memisahkan aplikasi ke beberapa project

Langkah selanjutnya

• Baca kuota Google Cloud.