Cuotas de frecuencia de Compute Engine

En este documento se indican las cuotas de frecuencia de Compute Engine, que definen el número de solicitudes que puedes enviar a los métodos de la API de Compute Engine.

Cuotas de frecuencia

Las cuotas de frecuencia (también conocidas como límites de frecuencia de API o cuotas de API) definen el número de solicitudes que se pueden enviar a la API Compute Engine. Estas cuotas se aplican por proyecto. Cada cuota se aplica a un grupo de uno o varios métodos de la API Compute Engine. Cuando usas la CLI de gcloud o la Google Cloud consola, también envías solicitudes a la API, y estas solicitudes se tienen en cuenta para tu cuota de frecuencia. Si usas cuentas de servicio para acceder a la API, también se contabilizará en tu cuota de frecuencia.

Google aplica cuotas de frecuencia en intervalos de un minuto (60 segundos) para cada grupo. Esto significa que, si tu proyecto alcanza el número máximo de solicitudes de API en un plazo de 60 segundos, debes esperar a que se reponga esa cuota de frecuencia antes de enviar más solicitudes en ese grupo. Si tu proyecto supera una cuota de frecuencia, recibirás un error 403 con el motivo rateLimitExceeded. Para resolver este error, espera un minuto y vuelve a intentar enviar tu solicitud. La cuota se volverá a rellenar al inicio del siguiente intervalo.

El número de solicitudes que puedes enviar a la API Compute Engine se define mediante cuotas de API, tal como se describe en las siguientes tablas. Cada grupo se cuenta por separado, por lo que puedes alcanzar la cuota máxima en cada grupo simultáneamente.

Cuotas de frecuencia para métodos globales

En las siguientes secciones se indican las cuotas que definen el número de solicitudes que puedes enviar a los métodos de la API global de Compute Engine.

Cuotas de API simplificadas para métodos globales

Para mejorar la visibilidad y la gestión de las cuotas de la API Compute Engine,Google Cloud ha reducido el número de métricas de cuota consolidando las métricas en menos cuotas. Estas métricas de cuota simplificadas también ofrecen límites más altos para cada cuota.

Para ver una lista completa de los métodos globales y las métricas de cuota que monitorizan el coste de cada método, consulte la referencia de métricas de cuota de la API de Compute Engine.

En la siguiente tabla se enumeran todas las métricas de cuota de API simplificadas de la API Compute Engine:

Cuota
Descripción de la cuota		 Nombre de la métrica
Solicitudes de lectura por minuto (GlobalReadsPerMinutePerProject)
Cuota de los métodos globales get y list. 		compute.googleapis.com/global_reads
Solicitudes de escritura por minuto (GlobalWritesPerMinutePerProject)
Cuota de métodos de escritura globales que no se incluyen en otras métricas de cuota. 		compute.googleapis.com/global_writes
Lista de solicitudes utilizables por minuto (GlobalListUsablePerMinutePerProject)
Cuota de métodos ListUsable globales. 		compute.googleapis.com/list_usable_requests
Solicitudes de invalidación de caché por minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Cuota de métodos UrlMapsService.InvalidateCache globales. 		compute.googleapis.com/global_cache_invalidation_requests
Sobrecarga de costes de la lista filtrada (ListRequestsFilterCostOverheadPerMinutePerProject)

Cuota para los métodos globales *.list y *.aggregatedList con filtros.

Google Cloud cobra el uso de la cuota de esta métrica, además de las cuotas de la métrica compute.googleapis.com/global_reads. Se te cobrará por la cuota si se filtran más de 10.000 recursos de las solicitudes de lista. La API de Compute Engine rechaza las solicitudes de lista si superas este límite de cuota.

 compute.googleapis.com/filtered_list_cost_overhead
Tasa por proyecto: 750.000 recursos filtrados de las solicitudes de lista por región y minuto. Como la cuota se cobra por cada 10.000 recursos, el límite es de 75 (750.000/10.000) cuando consultas este límite de cuota en la consola de Google Cloud .
Solicitudes por minuto (GlobalRequestsPerMinutePerProject)

Cuota de todas las solicitudes de lectura y escritura globales.

 compute.googleapis.com/global_requests

Cuotas de las APIs antiguas para métodos globales

En la siguiente tabla se indican todas las cuotas de la API Compute Engine para métodos globales.

Cuota
Descripción de la cuota		 Nombre de la métrica
Consultas por minuto (defaultPerMinutePerProject)
Cuota de métodos de lista y mutación globales que no se incluyen en otras métricas de cuota.

Los siguientes métodos de get también usan esta métrica de default:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default
Solicitudes de lectura (versión antigua) (ReadRequestsPerMinutePerProject)
Cuota de métodos globales *.get.		 compute.googleapis.com/read_requests
Solicitudes de lista (ListRequestsPerMinutePerProject)
Cuota de métodos globales *.list.		 compute.googleapis.com/list_requests
Solicitudes de lectura de operaciones (OperationReadRequestsPerMinutePerProject)
Cuota del método globalOperations.get.		 compute.googleapis.com/operation_read_requests
Solicitudes de mutación de recursos globales (GlobalResourceWriteRequestsPerMinutePerProject)
Cuota para los métodos images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert y machineImages.delete.		 compute.googleapis.com/global_resource_write_requests
Solicitudes de mutación pesadas (HeavyWeightWriteRequestsPerMinutePerProject)
Cuota de los métodos patch, delete y insert para los recursos interconnects.		 compute.googleapis.com/heavy_weight_write_requests
Solicitudes de lectura pesadas (HeavyWeightReadRequestsPerMinutePerProject)
Cuota para los métodos *.aggregatedList.		 compute.googleapis.com/heavy_weight_read_requests

Las siguientes cuotas se aplican a las APIs globales con cuotas por método:

Cuota
Descripción de la cuota		 Nombre de la métrica Límite predeterminado
Solicitudes de inserción de licencias
Cuotas del método licenses.insert.		 compute.googleapis.com/license_insert_requests
  • Cuota por proyecto (LicenseInsertRequestsPerMinutePerProject): 2,5 solicitudes por segundo (150 solicitudes por minuto)
  • Cuota por día y por proyecto (LicenseInsertRequestsPerDayPerProject): 30 solicitudes al día
Cuota de solicitudes de metadatos de instancia comunes de proyectos para el método projects.setCommonInstanceMetadata.
 compute.googleapis.com/project_set_common_instance_metadata_requests Cuota por proyecto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 solicitudes por minuto

Cuotas de frecuencia para métodos regionales y zonales

En las siguientes secciones se enumeran todas las cuotas que se aplican a los métodos que usan métricas regionales.

Cuotas de API simplificadas para métodos regionales y zonales

En la siguiente tabla se indican todas las cuotas simplificadas de los métodos regionales y zonales de la API de Compute Engine. Para ver una lista completa de los métodos regionales y zonales, así como las métricas de cuota que monitorizan el uso de cada método, consulta la referencia de métricas de cuota de la API de Compute Engine.

Cuota
Descripción de la cuota		 Nombre de la métrica
Solicitudes de lectura por minuto y región (ReadRequestsPerMinutePerProjectPerRegion)
Cuota de los métodos `get` y `list` regionales y zonales.		 compute.googleapis.com/reads_per_region
Solicitudes de escritura por región (WritesPerMinutePerProjectPerRegion)
Cuota de métodos de escritura zonales y regionales que no se incluyen en otras métricas de cuota. 		compute.googleapis.com/writes_per_region
Lista de solicitudes utilizables por región (ListUsablePerMinutePerProjectPerRegion)
Cuota de métodos ListUsable regionales y por zonas. 		compute.googleapis.com/list_usable_requests_per_region
Sobrecarga de costes de listas filtradas por región

Cuota para los métodos regionales y zonales *.list y *.aggregatedList con filtros.

Google Cloud cobra el uso de la cuota de esta métrica, además de las cuotas de la métrica compute.googleapis.com/reads_per_region. Se te cobrará por la cuota si se filtran más de 10.000 recursos de las solicitudes de lista. La API de Compute Engine rechaza las solicitudes de lista si superas este límite de cuota.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Tarifa por proyecto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 recursos filtrados de las solicitudes de lista por región y por minuto. Como la cuota se cobra por cada 10.000 recursos, el límite es de 75 (750.000/10.000) cuando consultas este límite de cuota en la consola de Google Cloud .
Solicitudes por minuto por región (RequestsPerMinutePerProjectPerRegion)

Cuota de todas las solicitudes de lectura y escritura regionales.

 compute.googleapis.com/requests_per_region

Cuotas de las APIs antiguas para métodos regionales

En la siguiente tabla se indican todas las cuotas de la API Compute Engine para los métodos regionales y zonales.

Cuota
Descripción de la cuota		 Nombre de la métrica
Consultas (QueriesPerMinutePerRegion)
Cuota de métodos regionales y zonales que crean, modifican o eliminan recursos de Compute Engine. Por ejemplo, los métodos instances.insert, disks.update y instances.delete.

Los siguientes métodos get, list y patch también usan esta métrica default_per_region:

  • 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
Solicitudes de lectura (versión antigua) (ReadRequestsPerMinutePerRegion)
Cuota para métodos regionales y zonales get como autoscalers.get, disks.get, instances.get y machineTypes.get.		 compute.googleapis.com/read_requests_per_region
Solicitudes de lista (ListRequestsPerMinutePerRegion)
Cuota para los métodos list regionales y zonales, como autoscalers.list, disks.list, instances.list y machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Sobrecarga de costes de listas filtradas

Cuota para los métodos *.list y *.aggregatedList con filtros.

Google Cloud cobra el uso de la cuota de esta métrica, además de las cuotas de las métricas compute.googleapis.com/list_requests_per_region y compute.googleapis.com/heavy_weight_read_requests_per_region. Se te cobrará por la cuota si se filtran más de 10.000 recursos de las solicitudes de lista. La API de Compute Engine rechaza las solicitudes de lista si superas este límite de cuota.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Tarifa por proyecto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 recursos filtrados de las solicitudes de lista por región y por minuto. Como la cuota se cobra por cada 10.000 recursos, el límite es de 75 (750.000/10.000) cuando consultas este límite de cuota en la consola de Google Cloud .
Solicitudes de lectura de operaciones (OperationReadRequestsPerMinutePerRegion)
Cuota para los métodos regionOperations.get y zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region
Solicitudes de mutación de recursos globales por región (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Cuota para los métodos disks.createSnapshot, y regionDisks.createSnapshot.		 compute.googleapis.com/global_resource_write_requests_per_region
Solicitudes de salida de puerto serie de una instancia (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Cuota del método instances.getSerialPortOutput.		 compute.googleapis.com/get_serial_port_output_requests_per_region
Solicitudes de lectura de gran peso (HeavyWeightReadRequestsPerMinutePerRegion)
Cuota para los métodos regionOperations.wait, zoneOperations.wait y regionNetworkFirewallPolicies.getEffectiveFirewalls.		 compute.googleapis.com/heavy_weight_read_requests_per_region
Solicitudes de mutación de peso elevado por región HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Cuota de los métodos patch, delete y insert para el recurso interconnectAttachments y para el método networks.updatePeering.		 compute.googleapis.com/heavy_weight_write_requests_per_region
Solicitudes de eventos simulados de mantenimiento de instancias (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Cuota del método instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
Solicitudes de referentes de la lista de instancias InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Cuota del método instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region
Solicitudes de escritura de puntos finales de red NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Cuota de los métodos networkEndpointGroups.attachNetworkEndpoints y networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region
Solicitudes de lista de puntos finales de red (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Cuota del método networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region
Solicitudes de escritura de puntos de conexión de red regionales (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Cuota para los métodos regionNetworkEndpointGroups.attachNetworkEndpoints y regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Solicitudes de lista de puntos finales de red regionales (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Cuota del método regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Solicitar un aumento de las cuotas de tarifas

Si necesitas una cuota mayor para hacer solicitudes a la API, puedes solicitar un aumento de la cuota de la API desde la Google Cloud consola. Para obtener instrucciones, consulta Solicitar un ajuste de cuota.

Prácticas recomendadas

Sigue las prácticas recomendadas de la API Compute Engine para conservar las cuotas de frecuencia y mitigar los efectos de las cuotas de frecuencia.

Siguientes pasos