Kuota kapasitas dan batas sistem Compute Engine

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

Kuota membatasi jumlah Google Cloud resource yang dapat digunakan project Anda. Jika ingin mengubah nilai kuota untuk mengakomodasi penggunaan resource yang lebih banyak, Anda dapat meminta penyesuaian kuota. Batas sistem adalah batasan tetap yang tidak dapat ditingkatkan atau diturunkan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Cloud Quotas.

Kuota kapasitas dan batas sistem

Kuota kapasitas (juga dikenal sebagai 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 untuk setiap grup. Jika project Anda mencapai jumlah maksimum permintaan API dalam waktu 60 detik, Anda harus menunggu kuota kapasitas tersebut diisi ulang sebelum membuat lebih banyak permintaan dalam grup tersebut. Misalnya, jika project mencapai batas kuota pada pukul 10.00.15, kuota akan diisi ulang pada awal interval tersinkronisasi berikutnya, seperti pukul 10.01.00, bukan langsung diisi ulang. 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 dan batas sistem untuk metode global

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

Kuota kapasitas dan batas sistem yang disederhanakan untuk metode global

Untuk meningkatkan kemampuan penemuan dan pengelolaan kuota Compute Engine API, Google Cloud telah mengurangi jumlah metrik kuota dengan menggabungkan metrik menjadi 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 kuota dan metrik API yang disederhanakan untuk Compute Engine API:

Kuota dan deskripsi	Nama metrik
Permintaan baca per menit (GlobalReadsPerMinutePerProject) Kuota untuk metode get dan list global.	compute.googleapis.com/global_reads
Permintaan tulis per menit (GlobalWritesPerMinutePerProject) Kuota untuk metode tulis global yang tidak disertakan dalam metrik kuota lainnya.	compute.googleapis.com/global_writes
Permintaan pembatalan cache per menit (GlobalCacheInvalidationRequestsPerMinutePerProject) Kuota untuk metode UrlMapsService.InvalidateCache global.	compute.googleapis.com/global_cache_invalidation_requests

Tabel berikut mencantumkan batas sistem dan metrik untuk Compute Engine API:

Catatan: Anda tidak dapat meminta batas yang lebih tinggi untuk batas sistem API Compute Engine API.

Batas sistem dan deskripsi	Nama metrik
Daftar permintaan yang dapat digunakan per menit (GlobalListUsablePerMinutePerProject) Batas sistem untuk metode ListUsable global.	compute.googleapis.com/list_usable_requests
Overhead biaya daftar yang difilter (ListRequestsFilterCostOverheadPerMinutePerProject) Batas sistem untuk *.list dan *.aggregatedList metode global dengan filter. Google Cloud mengenakan biaya penggunaan kuota untuk metrik ini selain kuota terhadap metrik compute.googleapis.com/global_reads. 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 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 Anda membuat kueri untuk batas kuota ini di Google Cloud konsol. Catatan: Untuk menghindari masalah kuota, optimalkan filter permintaan daftar atau gunakan filter daftar di sisi klien.
Permintaan per menit (GlobalRequestsPerMinutePerProject) Batas sistem untuk semua permintaan baca dan tulis global.	compute.googleapis.com/global_requests

Kuota dan batas sistem API lama untuk metode global

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

Catatan: Metrik global berikut akan terus ada, tetapi sebaiknya gunakan metrik kuota API yang disederhanakan untuk menetapkan pemberitahuan dan melacak penggunaan API di dasbor Cloud Monitoring Anda.

Kuota dan deskripsi	Nama metrik
Kueri per menit (defaultPerMinutePerProject) Kuota untuk metode daftar dan mutasi 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 (lama) (ReadRequestsPerMinutePerProject) Kuota 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 globalOperations.get metode.	compute.googleapis.com/operation_read_requests
Permintaan mutasi resource global (GlobalResourceWriteRequestsPerMinutePerProject) Kuota untuk images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert, dan machineImages.delete metode.	compute.googleapis.com/global_resource_write_requests
Permintaan mutasi berat (HeavyWeightWriteRequestsPerMinutePerProject) Kuota untuk patch, delete, dan insert metode untuk resource interconnects.	compute.googleapis.com/heavy_weight_write_requests
Permintaan baca berat (HeavyWeightReadRequestsPerMinutePerProject) Kuota untuk *.aggregatedList metode.	compute.googleapis.com/heavy_weight_read_requests

Kuota berikut berlaku untuk API global dengan kuota per metode:

Kuota dan 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 dan batas sistem untuk metode regional dan zona

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

Kuota dan batas API yang disederhanakan untuk metode regional dan zona

Tabel berikut mencantumkan metrik kuota API yang disederhanakan 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 dan deskripsi	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 tulis per region (WritesPerMinutePerProjectPerRegion) Kuota untuk metode tulis regional dan zona yang tidak disertakan dalam metrik kuota lainnya.	compute.googleapis.com/writes_per_region

Tabel berikut mencantumkan batas sistem untuk metode regional dan zona Compute Engine API:

Catatan: Anda tidak dapat meminta batas yang lebih tinggi untuk batas sistem API Compute Engine API.

Batas sistem dan deskripsi	Nama metrik
Daftar permintaan yang dapat digunakan per region (ListUsablePerMinutePerProjectPerRegion) Batas sistem untuk metode ListUsable regional dan zona.	compute.googleapis.com/list_usable_requests_per_region
Overhead biaya daftar yang difilter per region Batas sistem untuk *.list dan *.aggregatedList metode regional dan zona dengan filter. Google Cloud mengenakan biaya penggunaan kuota untuk metrik ini selain kuota terhadap metrik compute.googleapis.com/reads_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 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 Anda membuat kueri untuk batas kuota ini di Google Cloud konsol. Catatan: Untuk menghindari masalah kuota, optimalkan filter permintaan daftar atau gunakan filter daftar di sisi klien.
Permintaan per menit per region (RequestsPerMinutePerProjectPerRegion) Batas sistem untuk semua permintaan baca dan tulis regional.	compute.googleapis.com/requests_per_region

Kuota dan batas sistem API lama untuk metode regional

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

Catatan: Metrik regional berikut akan terus ada, tetapi sebaiknya gunakan metrik kuota API yang disederhanakan untuk menetapkan pemberitahuan dan melacak penggunaan API di dasbor Cloud Monitoring Anda:

Kuota dan deskripsi	Nama metrik
Kueri (QueriesPerMinutePerRegion) Kuota untuk metode regional dan zona yang membuat, mengubah, atau menghapus resource Compute Engine. Misalnya, instances.insert, disks.update, dan metode 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 (lama) (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
Permintaan baca operasi (OperationReadRequestsPerMinutePerRegion) Kuota untuk regionOperations.get dan zoneOperations.get metode.	compute.googleapis.com/operation_read_requests_per_region
Permintaan mutasi resource global per region (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion) Kuota untuk disks.createSnapshot, dan regionDisks.createSnapshot metode.	compute.googleapis.com/global_resource_write_requests_per_region
Permintaan output port serial get instance (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion) Kuota untuk metode instances.getSerialPortOutput.	compute.googleapis.com/get_serial_port_output_requests_per_region
Permintaan baca berat (HeavyWeightReadRequestsPerMinutePerRegion) Kuota untuk regionOperations.wait, zoneOperations.wait, dan regionNetworkFirewallPolicies.getEffectiveFirewalls metode.	compute.googleapis.com/heavy_weight_read_requests_per_region
Permintaan mutasi berat per region HeavyWeightWriteRequestsPerMinutePerProjectPerRegion Kuota untuk patch, delete, dan insert metode untuk interconnectAttachments resource dan untuk metode networks.updatePeering.	compute.googleapis.com/heavy_weight_write_requests_per_region
Permintaan peristiwa pemeliharaan simulasi instance (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion) Kuota untuk instances.simulateMaintenanceEvent metode.	compute.googleapis.com/simulate_maintenance_event_requests_per_region
Permintaan perujuk daftar instance InstanceListReferrersRequestsPerMinutePerProjectPerRegion Kuota untuk instances.listReferrers metode.	compute.googleapis.com/instance_list_referrers_requests_per_region
Permintaan tulis endpoint jaringan NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion Kuota untuk networkEndpointGroups.attachNetworkEndpoints dan networkEndpointGroups.detachNetworkEndpoints metode.	compute.googleapis.com/network_endpoint_write_requests_per_region
Permintaan daftar endpoint jaringan (NetworkEndpointListRequestsPerMinutePerProjectPerRegion) Kuota untuk networkEndpointGroups.listNetworkEndpoints metode.	compute.googleapis.com/network_endpoint_list_requests_per_region
Permintaan tulis endpoint jaringan regional (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion) Kuota untuk regionNetworkEndpointGroups.attachNetworkEndpoints dan regionNetworkEndpointGroups.detachNetworkEndpoints metode.	compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Permintaan daftar endpoint jaringan regional (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion) Kuota untuk regionNetworkEndpointGroups.listNetworkEndpoints metode.	compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Tabel berikut mencantumkan batas sistem lama untuk metode regional dan zona Compute Engine API:

Catatan: Anda tidak dapat meminta batas yang lebih tinggi untuk batas sistem API Compute Engine API.

Batas sistem dan deskripsi

Nama metrik

Overhead biaya daftar yang difilter Batas sistem untuk *.list dan *.aggregatedList metode dengan filter. Google Cloud mengenakan biaya penggunaan kuota untuk metrik ini selain kuota terhadap 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 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 Anda membuat kueri untuk batas kuota ini di Google Cloud konsol. Catatan: Untuk menghindari masalah kuota, optimalkan filter permintaan daftar atau gunakan filter daftar di sisi klien.

Meminta peningkatan kuota kapasitas

Jika memerlukan kuota yang lebih tinggi untuk membuat permintaan API, Anda dapat meminta peningkatan kuota API dari Google Cloud konsol. 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

• Pelajari penggunaan Monitoring API.
• Pelajari cara menyiapkan pemberitahuan kuota.