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 grup kuota 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 metrik global

Grup kuota berikut berlaku untuk semua resource kecuali jika ditentukan lain:

Grup kuota
Deskripsi		 Nama metrik Kuota default
Kueri
Kuota untuk metode mutasi global.

Metode get berikut juga menggunakan metrik default ini:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default Kuota per project (defaultPerMinutePerProject): 1.500 permintaan/menit
Permintaan baca
Kuota untuk metode *.get global.		 compute.googleapis.com/read_requests Kuota per project (ReadRequestsPerMinutePerProject): 1.500 permintaan/menit
Permintaan daftar
Kuota untuk metode *.list global.		 compute.googleapis.com/list_requests Kuota per project (ListRequestsPerMinutePerProject): 1.500 permintaan/menit
Permintaan baca operasi
Kuota untuk metode globalOperations.get.		 compute.googleapis.com/operation_read_requests Kapasitas per project (OperationReadRequestsPerMinutePerProject): 1.500 permintaan/menit
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 dan compute.googleapis.com/heavy_weight_read_requests. Anda dikenakan 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_overheadBETA Kapasitas per project (ListRequestsFilterCostOverheadPerMinutePerProject): 750 ribu resource yang difilter/menit
Permintaan mutasi resource global
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 Kapasitas per project (GlobalResourceWriteRequestsPerMinutePerProject): 375 permintaan/menit
Permintaan mutasi berat
Kuota untuk metode patch, delete, dan insert untuk resource interconnects.		 compute.googleapis.com/heavy_weight_write_requests Kapasitas per project (HeavyWeightWriteRequestsPerMinutePerProject): 750 permintaan/menit
Permintaan baca berat
Kuota untuk metode *.aggregatedList.		 compute.googleapis.com/heavy_weight_read_requests Kapasitas per project (HeavyWeightReadRequestsPerMinutePerProject): 750 permintaan/menit

Grup kuota berikut berlaku untuk API global dengan kuota per metode:

Grup kuota
Deskripsi		 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 metrik regional

Kuota berikut berlaku untuk metode yang menggunakan metrik regional:

Grup kuota
Deskripsi		 Nama metrik Kuota default
Kuota per project per region
Kueri
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 Queries per minute per region: 1500
Permintaan baca
Kuota untuk metode get regional dan zona seperti autoscalers.get, disks.get, instances.get, dan machineTypes.get.		 compute.googleapis.com/read_requests_per_region Read requests per minute per region: 1500
Permintaan daftar
Kuota untuk metode list regional dan zona seperti autoscalers.list, disks.list, instances.list, dan machineTypes.list.		 compute.googleapis.com/list_requests_per_region List requests per minute per region: 1500
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 dikenakan 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_regionBETA Kapasitas per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750 ribu resource yang difilter/menit
Permintaan baca operasi
Kuota untuk metode regionOperations.get dan zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region Operation read requests per minute per region: 1500
Permintaan mutasi resource global per region
Kuota untuk metode disks.createSnapshot, dan regionDisks.createSnapshot.		 compute.googleapis.com/global_resource_write_requests_per_region GlobalResourceWriteRequestsPerMinutePerProjectPerRegion: 375
Instance mendapatkan permintaan output port serial
Kuota untuk metode instances.getSerialPortOutput.		 compute.googleapis.com/get_serial_port_output_requests_per_region GetSerialPortOutputRequestsPerMinutePerProjectPerRegion: 1500
Permintaan baca berat
Kuota untuk metode regionOperations.wait, zoneOperations.wait, dan regionNetworkFirewallPolicies.getEffectiveFirewalls.		 compute.googleapis.com/heavy_weight_read_requests_per_region Heavyweight read requests per minute: 750
Permintaan mutasi berat per region
Kuota untuk metode patch, delete, dan insert untuk resource interconnectAttachments dan untuk metode networks.updatePeering.		 compute.googleapis.com/heavy_weight_write_requests_per_region HeavyWeightWriteRequestsPerMinutePerProjectPerRegion: 750
Instance permintaan simulasikan skenario pemeliharaan
Kuota untuk metode instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion: 150
Instance permintaan cantumkan perujuk
Kuota untuk metode instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region InstanceListReferrersRequestsPerMinutePerProjectPerRegion: 3000
Permintaan tulis endpoint jaringan
Kuota untuk metode networkEndpointGroups.attachNetworkEndpoints dan networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500
Permintaan daftar endpoint jaringan
Kuota untuk metode networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500
Permintaan tulis endpoint jaringan regional
Kuota untuk metode regionNetworkEndpointGroups.attachNetworkEndpoints dan regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150
Permintaan daftar endpoint jaringan regional
Kuota untuk metode regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500

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 kuota yang lebih tinggi.

Praktik terbaik

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

Langkah selanjutnya