Compute Engine rate quotas

This document lists the Compute Engine rate quotas, which define the number ofrequests you can make to Compute Engine API methods.

Rate quotas

Rate quotas (also known as API rate limits or API quotas) define the number ofrequests that can be made to theCompute Engine API.These quotas apply on a per-project basis. Each quota applies to a group of oneor more Compute Engine API methods. When you use the gcloud CLI orthe Google Cloud console, you are also making requests to the API and theserequests count towards your rate quota. If you use service accounts to accessthe API, that also counts towards your rate quota.

Google enforces rate quotas at a per-minute (60 seconds) interval for eachgroup. That means if your project reaches the maximum number of API requestsanytime within 60 seconds, you must wait for that rate quota to refill beforemaking more requests in that group. If your project exceeds a rate quota, youreceive a 403 error with the reasonrateLimitExceeded. To resolve this error,wait a minute then try your request again—the quota should be refilled atthe start of the next interval.

The number of requests that you can make to the Compute Engine API is defined byAPI quotas as described in the following tables. Each group is countedseparately, so you can achieve the maximum quota in each group simultaneously.

Rate quotas for global methods

The following sections list the quotas that define the number of requests youcan make to the global Compute Engine API methods.

Simplified API quotas for global methods

To improve the discoverability and manageability of Compute Engine API quota,Google Cloud has reduced the number of quota metrics by consolidating metricsinto fewer quotas. These simplified quota metrics also offer higher limitsfor each quota.

To view a complete list of global methods and the quota metrics that trackthe cost of each method, seeCompute Engine API quota metrics reference.

The following table lists all simplified API quota metrics for Compute Engine API:

Quota
Quota description
Metric name
Read requests per minute (GlobalReadsPerMinutePerProject)
Quota for globalget andlist methods.
compute.googleapis.com/global_reads
Write requests per minute (GlobalWritesPerMinutePerProject)
Quota for global write methods that are not included under other quota metrics.
compute.googleapis.com/global_writes
List usable requests per minute (GlobalListUsablePerMinutePerProject)
Quota for globalListUsable methods.
compute.googleapis.com/list_usable_requests
Cache invalidation requests per minute (GlobalCacheInvalidationRequestsPerMinutePerProject)
Quota for globalUrlMapsService.InvalidateCache methods.
compute.googleapis.com/global_cache_invalidation_requests
Filtered list cost overhead (ListRequestsFilterCostOverheadPerMinutePerProject)

Quota for*.list and*.aggregatedList global methods with filters.

Google Cloud charges quota usage for this metric in addition to the quotas against thecompute.googleapis.com/global_reads metric. You incur quota charges if there are more than 10k resources filtered out of the list requests. Compute Engine API rejects the list requests if you exceed this quota limit.

compute.googleapis.com/filtered_list_cost_overhead
Rate per project: 750k resources filtered out of the list requests per region per minute. As the quota is charged for every 10k resources, you see the limit as 75 (750k/10k) when you query for this quota limit on the Google Cloud console.Note: You cannot request a higher limit for this quota. To avoid quota issues, optimize your list request filters oruse list filters on the client side.
Requests per minute (GlobalRequestsPerMinutePerProject)

Quota for all global read and write requests.

compute.googleapis.com/global_requests
Note: You cannot request a higher limit for this quota.

Legacy API quotas for global methods

The following table lists all Compute Engine API quotas for global methods.

Note: The following global metrics continue to exist, but we recommend that you use thesimplified API quota metricsto set alerts and to track API usage on your Cloud Monitoringdashboards.
Quota
Quota description
Metric name
Queries per minute (defaultPerMinutePerProject)
Quota for global list and mutation methods that are not included under other quota metrics.

The followingget methods also use thisdefault metric:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
compute.googleapis.com/default
Read requests (legacy) (ReadRequestsPerMinutePerProject)
Quota for global*.get methods.
compute.googleapis.com/read_requests
List requests (ListRequestsPerMinutePerProject)
Quota for global*.list methods.
compute.googleapis.com/list_requests
Operation read requests (OperationReadRequestsPerMinutePerProject)
Quota forglobalOperations.get method.
compute.googleapis.com/operation_read_requests
Global resource mutation requests (GlobalResourceWriteRequestsPerMinutePerProject)
Quota forimages.delete,images.deprecate,images.insert,images.setLabels,snapshots.delete,snapshots.insert,snapshots.setLabels,machineImages.insert, andmachineImages.delete methods.
compute.googleapis.com/global_resource_write_requests
Heavy-weight mutation requests (HeavyWeightWriteRequestsPerMinutePerProject)
Quota forpatch,delete, andinsert methods for theinterconnects resources.
compute.googleapis.com/heavy_weight_write_requests
Heavy-weight read requests (HeavyWeightReadRequestsPerMinutePerProject)
Quota for*.aggregatedList methods.
compute.googleapis.com/heavy_weight_read_requests

The following quotas apply to global APIs with per method quotas:

Quota
Quota description
Metric nameDefault limit
License insert requests
Quotas forlicenses.insert method.
compute.googleapis.com/license_insert_requests
  • Quota per project (LicenseInsertRequestsPerMinutePerProject): 2.5 requests/second (150 requests/minute)
  • Quota per day per project (LicenseInsertRequestsPerDayPerProject): 30 requests/day
Project set common instance metadata requests
Quota forprojects.setCommonInstanceMetadata method.
compute.googleapis.com/project_set_common_instance_metadata_requestsQuota per project (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 requests/minute

Rate quotas for regional and zonal methods

The following sections list all quotas that apply to methods that useregional metrics.

Simplified API quotas for regional and zonal methods

The following table lists all simplified quotas for Compute Engine API regionaland zonal methods.To view a complete list of regional and zonal methods, and the quota metrics that trackthe usage of each method, seeCompute Engine API quota metrics reference.

Quota
Quota description
Metric name
Read requests per minute per region (ReadRequestsPerMinutePerProjectPerRegion)
Quota for regional and zonal `get` and `list` methods.
compute.googleapis.com/reads_per_region
Write requests per region (WritesPerMinutePerProjectPerRegion)
Quota for regional and zonal write methods that are not included under other quota metrics.
compute.googleapis.com/writes_per_region
List usable requests per region (ListUsablePerMinutePerProjectPerRegion)
Quota for regional and zonalListUsable methods.
compute.googleapis.com/list_usable_requests_per_region
Filtered list cost overhead per region

Quota for*.list and*.aggregatedList regional and zonal methods with filters.

Google Cloud charges quota usage for this metric in addition to the quotas against thecompute.googleapis.com/reads_per_region metric. You incur quota charges if there are more than 10k resources filtered out of the list requests. Compute Engine API rejects the list requests if you exceed this quota limit.

compute.googleapis.com/filtered_list_cost_overhead_per_region
Rate per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750k resources filtered out of the list requests per region per minute. As the quota is charged for every 10k resources, you see the limit as 75 (750k/10k) when you query for this quota limit on the Google Cloud console.Note: You cannot request a higher limit for this quota. To avoid quota issues, optimize your list request filters oruse list filters on the client side.
Requests per minute per region (RequestsPerMinutePerProjectPerRegion)

Quota for all regional read and write requests.

compute.googleapis.com/requests_per_region
Note: You cannot request a higher limit for this quota.

Legacy API quotas for regional methods

The following table lists all Compute Engine API quotas for regional and zonal methods.

Note: The following regional metrics continue to exist, but we recommend that you use thesimplified API quota metricsto set alerts and to track API usage on your Cloud Monitoringdashboards:
Quota
Quota description
Metric name
Queries (QueriesPerMinutePerRegion)
Quota for regional and zonal methods that create, modify, or delete Compute Engine resources. For example,instances.insert,disks.update, andinstances.delete methods.

The followingget,list andpatch methods also use thisdefault_per_region metric:

  • 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
Read requests (legacy) (ReadRequestsPerMinutePerRegion)
Quota for regional and zonalget methods such asautoscalers.get,disks.get,instances.get, andmachineTypes.get.
compute.googleapis.com/read_requests_per_region
List requests (ListRequestsPerMinutePerRegion)
Quota for regional and zonallist methods such asautoscalers.list,disks.list,instances.list, andmachineTypes.list.
compute.googleapis.com/list_requests_per_region
Filtered list cost overhead

Quota for*.list and*.aggregatedList methods with filters.

Google Cloud charges quota usage for this metric in addition to the quotas against thecompute.googleapis.com/list_requests_per_region andcompute.googleapis.com/heavy_weight_read_requests_per_region metrics. You incur quota charges if there are more than 10k resources filtered out of the list requests. Compute Engine API rejects the list requests if you exceed this quota limit.

compute.googleapis.com/filtered_list_cost_overhead_per_region
Rate per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750k resources filtered out of the list requests per region per minute. As the quota is charged for every 10k resources, you see the limit as 75 (750k/10k) when you query for this quota limit on the Google Cloud console.Note: You cannot request a higher limit for this quota. To avoid quota issues, optimize your list request filters oruse list filters on the client side.
Operation read requests (OperationReadRequestsPerMinutePerRegion)
Quota forregionOperations.get andzoneOperations.get methods.
compute.googleapis.com/operation_read_requests_per_region
Global resource mutation requests per region (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Quota fordisks.createSnapshot, andregionDisks.createSnapshot methods.
compute.googleapis.com/global_resource_write_requests_per_region
Instance get serial port output requests (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Quota forinstances.getSerialPortOutput method.
compute.googleapis.com/get_serial_port_output_requests_per_region
Heavy weight read requests (HeavyWeightReadRequestsPerMinutePerRegion)
Quota forregionOperations.wait,zoneOperations.wait, andregionNetworkFirewallPolicies.getEffectiveFirewalls methods.
compute.googleapis.com/heavy_weight_read_requests_per_region
Heavy weight mutation requests per regionHeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Quota forpatch,delete, andinsert methods forinterconnectAttachments resource and for thenetworks.updatePeering method.
compute.googleapis.com/heavy_weight_write_requests_per_region
Instance simulate maintenance event requests (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Quota forinstances.simulateMaintenanceEvent method.
compute.googleapis.com/simulate_maintenance_event_requests_per_region
Instance list referrer requestsInstanceListReferrersRequestsPerMinutePerProjectPerRegion
Quota forinstances.listReferrers method.
compute.googleapis.com/instance_list_referrers_requests_per_region
Network endpoint write requestsNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Quota fornetworkEndpointGroups.attachNetworkEndpoints andnetworkEndpointGroups.detachNetworkEndpoints methods.
compute.googleapis.com/network_endpoint_write_requests_per_region
Network endpoint list requests (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota fornetworkEndpointGroups.listNetworkEndpoints method.
compute.googleapis.com/network_endpoint_list_requests_per_region
Regional network endpoint write requests (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota forregionNetworkEndpointGroups.attachNetworkEndpoints andregionNetworkEndpointGroups.detachNetworkEndpoints methods.
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Regional network endpoint list requests (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota forregionNetworkEndpointGroups.listNetworkEndpoints method.
compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Request an increase in rate quotas

If you need a higher quota for making API requests, you can request an increasein the API quota from the Google Cloud console. For instructions,seeRequest a quota adjustment.

Best practices

Follow the Compute Engine API best practices forpreserving rate quotasto mitigate the effects of rate quotas.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.