Cuotas de frecuencia de Compute Engine


En este documento, se enumeran las cuotas de frecuencia de Compute Engine, que definen la cantidad de solicitudes que puedes realizar 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 la API o cuotas de API) definen la cantidad de solicitudes que se pueden realizar a la API de Compute Engine. Estas cuotas se aplican por proyecto. Cada cuota se aplica a un grupo de uno o más métodos de la API de Compute Engine. Cuando usas gcloud CLI o la consola de Google Cloud , también realizas solicitudes a la API, que se suman a tu cuota de frecuencia. Si usas cuentas de servicio para acceder a la API, estas también se tienen en cuenta en tu cuota de frecuencia.

Google aplica cuotas de frecuencia a un intervalo por minuto (60 segundos) para cada grupo. Esto significa que si tu proyecto alcanza la cantidad máxima de solicitudes a la API en cualquier momento en 60 segundos, debes esperar a que se vuelva a completar esa cuota de frecuencia antes de realizar más solicitudes en ese grupo. Si tu proyecto excede una cuota de frecuencia, recibirás un error 403 con el motivo rateLimitExceeded. Para resolver este error, espera un minuto y, luego, vuelve a hacer tu solicitud; la cuota debe volver a completarse al inicio del siguiente intervalo.

La cantidad de solicitudes que puedes realizar a la API de Compute Engine se define según las cuotas de API, como se describe en las siguientes tablas. Cada grupo se cuenta por separado, por lo que puedes alcanzar el límite máximo en cada grupo de forma simultánea.

Cuotas de frecuencia para métodos globales

En las siguientes secciones, se enumeran las cuotas que definen la cantidad de solicitudes que puedes realizar a los métodos globales de la API de Compute Engine.

Cuotas de API simplificadas para métodos globales

Para mejorar la visibilidad y la capacidad de administración de la cuota de la API de Compute Engine, Google Cloud redujo la cantidad 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 hacen un seguimiento del costo de cada método, consulta 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 de Compute Engine:

Cuota
Descripción de la cuota
Nombre de la métrica
Solicitudes de lectura por minuto (GlobalReadsPerMinutePerProject)
Cuota para métodos get y list globales.
compute.googleapis.com/global_reads
Solicitudes de escritura por minuto (GlobalWritesPerMinutePerProject)
Cuota para los 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 para métodos ListUsable globales.
compute.googleapis.com/list_usable_requests
Solicitudes de invalidación de caché por minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Cuota para métodos UrlMapsService.InvalidateCache globales.
compute.googleapis.com/global_cache_invalidation_requests
Sobrecarga de costos de la lista filtrada (ListRequestsFilterCostOverheadPerMinutePerProject)

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

Google Cloud cobra el uso de la cuota para esta métrica, además de las cuotas en función de la métrica compute.googleapis.com/global_reads. Se generan cargos de cuota si hay más de 10,000 recursos filtrados 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 por minuto. Como la cuota se cobra por cada 10,000 recursos, verás el límite como 75 (750,000/10,000) cuando consultes este límite de cuota en la consola de Google Cloud .
Solicitudes por minuto (GlobalRequestsPerMinutePerProject)

Cuota para todas las solicitudes de lectura y escritura globales.

compute.googleapis.com/global_requests

Cuotas de API heredadas para métodos globales

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

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

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

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
compute.googleapis.com/default
Solicitudes de lectura (heredada) (ReadRequestsPerMinutePerProject)
Cuota para métodos *.get globales.
compute.googleapis.com/read_requests
Solicitudes de lista (ListRequestsPerMinutePerProject)
Cuota para métodos *.list globales.
compute.googleapis.com/list_requests
Solicitudes de operaciones de lectura (OperationReadRequestsPerMinutePerProject)
Cuota para el 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 para los métodos patch, delete y insert de los recursos interconnects.
compute.googleapis.com/heavy_weight_write_requests
Solicitudes de operaciones 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 para el método licenses.insert.
compute.googleapis.com/license_insert_requests
  • Frecuencia por proyecto (LicenseInsertRequestsPerMinutePerProject): 2.5 solicitudes por segundo (150 solicitudes por minuto)
  • Frecuencia por día, por proyecto (LicenseInsertRequestsPerDayPerProject): 30 solicitudes por día
Solicitudes de establecimiento de metadatos comunes de instancia del proyecto
Límite del 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 enumeran todas las cuotas simplificadas para los métodos regionales y zonales de la API de Compute Engine. Para ver una lista completa de los métodos regionales y zonales, y las métricas de cuota que hacen un seguimiento del 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 por región (ReadRequestsPerMinutePerProjectPerRegion)
Límite para los métodos "get" y "list" regionales y zonales.
compute.googleapis.com/reads_per_region
Solicitudes de escritura por región (WritesPerMinutePerProjectPerRegion)
Cuota para los métodos de escritura regionales y zonales 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 para métodos ListUsable regionales y zonales.
compute.googleapis.com/list_usable_requests_per_region
Sobrecarga de costos de la lista filtrada por región

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

Google Cloud cobra el uso de la cuota para esta métrica, además de las cuotas en función de la métrica compute.googleapis.com/reads_per_region. Se generan cargos de cuota si hay más de 10,000 recursos filtrados 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
Tasa por proyecto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750,000 recursos filtrados de las solicitudes de lista por región por minuto. Como la cuota se cobra por cada 10,000 recursos, verás el límite como 75 (750,000/10,000) cuando consultes este límite de cuota en la consola de Google Cloud .
Solicitudes por minuto por región (RequestsPerMinutePerProjectPerRegion)

Es la cuota para todas las solicitudes de lectura y escritura regionales.

compute.googleapis.com/requests_per_region

Cuotas de API heredadas para métodos regionales

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

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

Los siguientes métodos get, list y patch también usan la 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 (heredada) (ReadRequestsPerMinutePerRegion)
Cuota para métodos get regionales y zonales, como autoscalers.get, disks.get, instances.get y machineTypes.get.
compute.googleapis.com/read_requests_per_region
Solicitudes de lista (ListRequestsPerMinutePerRegion)
Cuota para 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 costos de la lista filtrada

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

Google Cloud cobra el uso de la cuota para esta métrica, además de las cuotas en las métricas compute.googleapis.com/list_requests_per_region y compute.googleapis.com/heavy_weight_read_requests_per_region. Se generan cargos de cuota si hay más de 10,000 recursos filtrados 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
Tasa por proyecto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750,000 recursos filtrados de las solicitudes de lista por región por minuto. Como la cuota se cobra por cada 10,000 recursos, verás el límite como 75 (750,000/10,000) cuando consultes este límite de cuota en la consola de Google Cloud .
Solicitudes de operaciones de lectura (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 obtención de salida de puerto en serie de instancias (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Cuota para el método instances.getSerialPortOutput.
compute.googleapis.com/get_serial_port_output_requests_per_region
Solicitudes de operaciones de lectura pesadas (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 pesadas por región HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Cuota para 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 de mantenimiento simulado de instancias (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Cuota para el método instances.simulateMaintenanceEvent.
compute.googleapis.com/simulate_maintenance_event_requests_per_region
Solicitudes de enumerar referentes de instancia InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Cuota para el método instances.listReferrers.
compute.googleapis.com/instance_list_referrers_requests_per_region
Solicitudes de escritura de extremos de red NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Cuota para métodos networkEndpointGroups.attachNetworkEndpoints y networkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/network_endpoint_write_requests_per_region
Solicitudes de lista de extremos de red (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Cuota para el método networkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/network_endpoint_list_requests_per_region
Solicitudes de escritura de extremos de red regionales (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Cuota para métodos regionNetworkEndpointGroups.attachNetworkEndpoints y regionNetworkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Solicitudes de lista de extremos de red regionales (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Cuota para el método regionNetworkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Solicita un aumento de las cuotas de tarifas

Si necesitas una cuota más alta para realizar solicitudes a la API, puedes solicitar un aumento de la cuota de la API desde la Google Cloud consola. Para obtener más información, consulta Solicita un ajuste de cuota.

Prácticas recomendadas

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

¿Qué sigue?