Kuota kapasitas Compute Engine

Dokumen ini berisi daftar kuota kapasitas Compute Engine, yang menentukan jumlah permintaan yang dapat Anda buat ke metode Compute Engine API.

Kuota kapasitas

Kuota kapasitas (juga dikenal sebagai batas kapasitas API atau kuota API) menentukan jumlah permintaan yang dapat dibuat ke Compute Engine API. Kuota ini berlaku per project. Setiap kuota berlaku untuk grup yang terdiri dari satu atau beberapa metode Compute Engine API. Saat menggunakan gcloud CLI atau konsol Google Cloud , Anda juga membuat permintaan ke API dan permintaan ini memengaruhi kuota kapasitas Anda. Jika Anda menggunakan akun layanan untuk mengakses API, hal tersebut juga akan mengurangi kuota kapasitas Anda.

Google menerapkan kuota kapasitas pada interval per menit (60 detik) untuk setiap grup. Artinya, jika project Anda mencapai jumlah maksimum permintaan API kapan saja dalam waktu 60 detik, Anda harus menunggu hingga kuota kapasitas diisi ulang sebelum membuat lebih banyak permintaan dalam grup tersebut. Jika project melebihi kuota kapasitas, Anda akan menerima error 403 dengan alasan rateLimitExceeded. Untuk mengatasi error ini, tunggu selama satu menit lalu coba lagi permintaan Anda—kuota akan diisi ulang pada awal interval berikutnya.

Jumlah permintaan yang dapat Anda buat ke Compute Engine API ditentukan oleh kuota API seperti yang dijelaskan dalam tabel berikut. Setiap grup dihitung secara terpisah, sehingga Anda dapat mencapai kuota maksimum di setiap grup secara bersamaan.

Kuota kapasitas untuk metode global

Bagian berikut mencantumkan kuota yang menentukan jumlah permintaan yang dapat Anda buat ke metode Compute Engine API global.

Kuota API yang disederhanakan untuk metode global

Untuk meningkatkan visibilitas dan pengelolaan kuota Compute Engine API, Google Cloud telah mengurangi jumlah metrik kuota dengan menggabungkan metrik ke dalam lebih sedikit kuota. Metrik kuota yang disederhanakan ini juga menawarkan batas yang lebih tinggi untuk setiap kuota.

Untuk melihat daftar lengkap metode global dan metrik kuota yang melacak biaya setiap metode, lihat referensi metrik kuota Compute Engine API.

Tabel berikut mencantumkan semua metrik kuota API yang disederhanakan untuk Compute Engine API:

Kuota
Deskripsi kuota		 Nama metrik
Permintaan baca per menit (GlobalReadsPerMinutePerProject)
Kuota untuk metode get dan list global. 		compute.googleapis.com/global_reads
Permintaan mutasi per menit (GlobalWritesPerMinutePerProject)
Kuota untuk metode tulis global yang tidak disertakan dalam metrik kuota lainnya. 		compute.googleapis.com/global_writes
Daftar permintaan yang dapat digunakan per menit (GlobalListUsablePerMinutePerProject)
Kuota untuk metode ListUsable global. 		compute.googleapis.com/list_usable_requests
Permintaan pembatalan validasi cache per menit (GlobalCacheInvalidationRequestsPerMinutePerProject)
Kuota untuk metode UrlMapsService.InvalidateCache global. 		compute.googleapis.com/global_cache_invalidation_requests
Overhead biaya daftar yang difilter (ListRequestsFilterCostOverheadPerMinutePerProject)

Kuota untuk *.list dan *.aggregatedList metode global dengan filter.

Google Cloud membebankan biaya penggunaan kuota untuk metrik ini selain kuota berdasarkan metrik compute.googleapis.com/global_reads. Anda akan dikenai biaya kuota jika ada lebih dari 10 ribu resource yang difilter dari permintaan daftar. Compute Engine API menolak permintaan daftar jika Anda melebihi batas kuota ini.

 compute.googleapis.com/filtered_list_cost_overhead
Kapasitas per project: 750 ribu resource yang difilter dari permintaan daftar per region per menit. Karena kuota dikenakan biaya untuk setiap 10 ribu resource, Anda akan melihat batasnya sebagai 75 (750 ribu/10 ribu) saat membuat kueri untuk batas kuota ini di konsol Google Cloud .
Permintaan per menit (GlobalRequestsPerMinutePerProject)

Kuota untuk semua permintaan baca dan tulis global.

 compute.googleapis.com/global_requests

Kuota API lama untuk metode global

Tabel berikut mencantumkan semua kuota Compute Engine API untuk metode global.

Kuota
Deskripsi kuota		 Nama metrik
Kueri per menit (defaultPerMinutePerProject)
Kuota untuk metode mutasi dan daftar global yang tidak disertakan dalam metrik kuota lainnya.

Metode get berikut juga menggunakan metrik default ini:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default
Permintaan baca (ReadRequestsPerMinutePerProject)
untuk metode *.get global.		 compute.googleapis.com/read_requests
Permintaan daftar (ListRequestsPerMinutePerProject)
Kuota untuk metode *.list global.		 compute.googleapis.com/list_requests
Permintaan baca operasi (OperationReadRequestsPerMinutePerProject)
Kuota untuk metode globalOperations.get.		 compute.googleapis.com/operation_read_requests
Permintaan mutasi resource global (GlobalResourceWriteRequestsPerMinutePerProject)
Kuota untuk metode images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert, dan machineImages.delete.		 compute.googleapis.com/global_resource_write_requests
Permintaan mutasi berat (HeavyWeightWriteRequestsPerMinutePerProject)
Kuota untuk metode patch, delete, dan insert untuk resource interconnects.		 compute.googleapis.com/heavy_weight_write_requests
Permintaan baca berat (HeavyWeightReadRequestsPerMinutePerProject)
Kuota untuk metode *.aggregatedList.		 compute.googleapis.com/heavy_weight_read_requests

Kuota berikut berlaku untuk API global dengan kuota per metode:

Kuota
Deskripsi kuota		 Nama metrik Batas default
Permintaan penyisipan lisensi
Kuota untuk metode licenses.insert.		 compute.googleapis.com/license_insert_requests
  • Kuota per project (LicenseInsertRequestsPerMinutePerProject): 2,5 permintaan/detik (150 permintaan/menit)
  • Kuota per hari per project (LicenseInsertRequestsPerDayPerProject): 30 permintaan/hari
Project menetapkan permintaan metadata instance umum
Kuota untuk metode projects.setCommonInstanceMetadata.		 compute.googleapis.com/project_set_common_instance_metadata_requests Kuota per project (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 permintaan/menit

Kuota kapasitas untuk metode regional dan zona

Bagian berikut mencantumkan semua kuota yang berlaku untuk metode yang menggunakan metrik regional.

Kuota API yang disederhanakan untuk metode regional dan zonal

Tabel berikut mencantumkan semua kuota sederhana untuk metode regional dan zona Compute Engine API. Untuk melihat daftar lengkap metode regional dan zona, serta metrik kuota yang melacak penggunaan setiap metode, lihat referensi metrik kuota Compute Engine API.

Kuota
Deskripsi kuota		 Nama metrik
Permintaan baca per menit per region (ReadRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode `get` dan `list` regional dan zona.		 compute.googleapis.com/reads_per_region
Permintaan mutasi (WritesPerMinutePerProjectPerRegion)
Kuota untuk metode tulis regional dan zona yang tidak disertakan dalam metrik kuota lainnya. 		compute.googleapis.com/writes_per_region
Mencantumkan permintaan yang dapat digunakan per region (ListUsablePerMinutePerProjectPerRegion)
Kuota untuk metode ListUsable regional dan zona. 		compute.googleapis.com/list_usable_requests_per_region
Overhead biaya daftar yang difilter per region

Kuota untuk *.list dan *.aggregatedList metode regional dan zonal dengan filter.

Google Cloud membebankan biaya penggunaan kuota untuk metrik ini selain kuota berdasarkan metrik compute.googleapis.com/reads_per_region. Anda akan dikenai biaya kuota jika ada lebih dari 10 ribu resource yang difilter dari permintaan daftar. Compute Engine API menolak permintaan daftar jika Anda melebihi batas kuota ini.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Kapasitas per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750 ribu resource yang difilter dari permintaan daftar per region per menit. Karena kuota dikenakan biaya untuk setiap 10 ribu resource, Anda akan melihat batasnya sebagai 75 (750 ribu/10 ribu) saat membuat kueri untuk batas kuota ini di konsol Google Cloud .
Permintaan per menit per region (RequestsPerMinutePerProjectPerRegion)

Kuota untuk semua permintaan baca dan tulis regional.

 compute.googleapis.com/requests_per_region

Kuota API lama untuk metode regional

Tabel berikut mencantumkan semua kuota Compute Engine API untuk metode regional dan zona.

Kuota
Deskripsi kuota		 Nama metrik
Kueri QueriesPerMinutePerRegion
Kuota untuk metode regional dan zona yang membuat, mengubah, atau menghapus resource Compute Engine. Misalnya, metode instances.insert, disks.update, dan instances.delete.

Metode get, list, dan patch berikut juga menggunakan metrik default_per_region ini:

  • projects.listXpnHosts
  • instances.getScreenshot
  • instances.getGuestAttributes
  • instances.getShieldedInstanceIdentity
  • instances.getEffectiveFirewalls
  • projects.listXpnHosts
  • instanceGroupManagers.listManagedInstances
  • instanceGroupManagers.listErrors
  • instanceGroupManagers.listPerInstanceConfigs
  • regionInstanceGroupManagers.listManagedInstances
  • regionInstanceGroupManagers.listErrors
  • regionInstanceGroupManagers.listPerInstanceConfigs
  • resourcePolicies.patch
 compute.googleapis.com/default_per_region
Permintaan baca ReadRequestsPerMinutePerRegion
Kuota untuk metode get regional dan zona seperti autoscalers.get, disks.get, instances.get, dan machineTypes.get.		 compute.googleapis.com/read_requests_per_region
Permintaan daftar ListRequestsPerMinutePerRegion
Kuota untuk metode list regional dan zona seperti autoscalers.list, disks.list, instances.list, dan machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Overhead biaya daftar yang difilter

Kuota untuk metode *.list dan *.aggregatedList dengan filter.

Google Cloud membebankan biaya penggunaan kuota untuk metrik ini selain kuota berdasarkan metrik compute.googleapis.com/list_requests_per_region dan compute.googleapis.com/heavy_weight_read_requests_per_region. Anda akan dikenai biaya kuota jika ada lebih dari 10 ribu resource yang difilter dari permintaan daftar. Compute Engine API menolak permintaan daftar jika Anda melebihi batas kuota ini.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Kapasitas per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750 ribu resource yang difilter dari permintaan daftar per region per menit. Karena kuota dikenakan biaya untuk setiap 10 ribu resource, Anda akan melihat batasnya sebagai 75 (750 ribu/10 ribu) saat membuat kueri untuk batas kuota ini di konsol Google Cloud .
Permintaan baca operasi (OperationReadRequestsPerMinutePerRegion)
Kuota untuk metode regionOperations.get dan zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region
Permintaan mutasi resource global per region (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode disks.createSnapshot, dan regionDisks.createSnapshot.		 compute.googleapis.com/global_resource_write_requests_per_region
Instance mendapatkan permintaan output port serial (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode instances.getSerialPortOutput.		 compute.googleapis.com/get_serial_port_output_requests_per_region
Permintaan baca berat (HeavyWeightReadRequestsPerMinutePerRegion)
Kuota untuk metode regionOperations.wait, zoneOperations.wait, dan regionNetworkFirewallPolicies.getEffectiveFirewalls.		 compute.googleapis.com/heavy_weight_read_requests_per_region
Permintaan mutasi berat per region HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Kuota untuk metode patch, delete, dan insert untuk resource interconnectAttachments dan untuk metode networks.updatePeering.		 compute.googleapis.com/heavy_weight_write_requests_per_region
Instance permintaan simulasi skenario pemeliharaan (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
Instance permintaan perujuk daftar InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Kuota untuk metode instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region
Permintaan tulis endpoint jaringan NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Kuota untuk metode networkEndpointGroups.attachNetworkEndpoints dan networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region
Permintaan daftar endpoint jaringan (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region
Permintaan tulis endpoint jaringan regional (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode regionNetworkEndpointGroups.attachNetworkEndpoints dan regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Permintaan daftar endpoint jaringan regional (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Kuota untuk metode regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Meminta peningkatan kuota kapasitas

Jika memerlukan kuota yang lebih tinggi untuk membuat permintaan API, Anda dapat meminta peningkatan kuota API dari konsol Google Cloud . Untuk mengetahui petunjuknya, lihat Meminta penyesuaian kuota.

Praktik terbaik

Ikuti praktik terbaik Compute Engine API untuk mempertahankan kuota kapasitas guna mengurangi efek kuota kapasitas.

Langkah berikutnya