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 puede realizar a la API de Compute Engine se define mediante grupos de cuotas, 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étricas globales

Los siguientes grupos de cuotas se aplican a todos los recursos, a menos que se especifique lo contrario:

Grupo de cuota
Descripción
Nombre de la métrica Cuota predeterminada
Consultas
Cuota para los métodos de 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 Frecuencia por proyecto (defaultPerMinutePerProject): 1,500 solicitudes por minuto
Solicitudes de lectura
Cuota para métodos *.get globales.
compute.googleapis.com/read_requests Frecuencia por proyecto (ReadRequestsPerMinutePerProject): 1,500 solicitudes por minuto
Solicitudes de lista
Cuota para métodos *.list globales.
compute.googleapis.com/list_requests Frecuencia por proyecto (ListRequestsPerMinutePerProject): 1,500 solicitudes por minuto
Solicitudes de lectura de operaciones
Cuota para el método globalOperations.get
compute.googleapis.com/operation_read_requests Frecuencia por proyecto (OperationReadRequestsPerMinutePerProject): 1,500 solicitudes por minuto
Sobrecarga de costos de lista filtrados

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 y compute.googleapis.com/heavy_weight_read_requests. Se generarán 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 Frecuencia por proyecto (ListRequestsFilterCostOverheadPerMinutePerProject): 750,000 recursos filtrados de las solicitudes de lista por región por minuto. Dado que 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 mutación de recursos globales
Cuota para 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 Frecuencia por proyecto (GlobalResourceWriteRequestsPerMinutePerProject): 375 solicitudes por minuto
Solicitudes de mutación pesadas
Cuota para los métodos patch, delete y insert de los recursos interconnects.
compute.googleapis.com/heavy_weight_write_requests Frecuencia por proyecto (HeavyWeightWriteRequestsPerMinutePerProject): 750 solicitudes por minuto
Solicitudes de lectura pesadas
Cuota para los métodos *.aggregatedList.
compute.googleapis.com/heavy_weight_read_requests Frecuencia por proyecto (HeavyWeightReadRequestsPerMinutePerProject): 750 solicitudes por minuto

Los siguientes grupos de cuotas se aplican a las APIs globales con cuotas por método:

Grupo de cuota
Descripción
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 Frecuencia por proyecto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 solicitudes por minuto

Cuotas de frecuencia para métricas regionales

Los siguientes límites se aplican a los métodos que usan métricas regionales:

Grupo de cuota
Descripción
Nombre de la métrica Cuota predeterminada
Cuota por proyecto y por región
Consultas
Límite 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 Queries per minute per region: 1500
Solicitudes de lectura
Límite para métodos get regionales y zonales, como autoscalers.get, disks.get, instances.get y machineTypes.get.
compute.googleapis.com/read_requests_per_region Read requests per minute per region: 1500
Solicitudes de lista
Límite para métodos list regionales y zonales, como autoscalers.list, disks.list, instances.list y machineTypes.list.
compute.googleapis.com/list_requests_per_region List requests per minute per region: 1500
Sobrecarga de costos de lista filtrados

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 generarán 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_regionBETA Frecuencia por proyecto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750,000 recursos filtrados de las solicitudes de lista por región por minuto. Dado que 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
Cuota para los métodos regionOperations.get y zoneOperations.get.
compute.googleapis.com/operation_read_requests_per_region Operation read requests per minute per region: 1500
Solicitudes mutación de recursos globales por región
Cuota para los métodos disks.createSnapshot y regionDisks.createSnapshot.
compute.googleapis.com/global_resource_write_requests_per_region GlobalResourceWriteRequestsPerMinutePerProjectPerRegion: 375
Solicitudes de obtención de salida de puertos en serie de instancias
Límite del método instances.getSerialPortOutput.
compute.googleapis.com/get_serial_port_output_requests_per_region GetSerialPortOutputRequestsPerMinutePerProjectPerRegion: 1500
Solicitudes de lectura pesadas
Cuota para los métodos regionOperations.wait, zoneOperations.wait y regionNetworkFirewallPolicies.getEffectiveFirewalls.
compute.googleapis.com/heavy_weight_read_requests_per_region Heavyweight read requests per minute: 750
Solicitudes de mutación pesadas por región
Límite 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 HeavyWeightWriteRequestsPerMinutePerProjectPerRegion: 750
Solicitudes de eventos de mantenimiento simulado de instancias
Límite para el método instances.simulateMaintenanceEvent.
compute.googleapis.com/simulate_maintenance_event_requests_per_region SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion: 150
Solicitudes de enumerar referentes de instancia
Cuota para el método instances.listReferrers.
compute.googleapis.com/instance_list_referrers_requests_per_region InstanceListReferrersRequestsPerMinutePerProjectPerRegion: 3000
Solicitudes de escritura de extremos de red
Límite para métodos networkEndpointGroups.attachNetworkEndpoints y networkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/network_endpoint_write_requests_per_region NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500
Solicitudes de enumeración de extremos de red
Cuota para el método networkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/network_endpoint_list_requests_per_region NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500
Solicitudes de escritura de extremos de red regionales
Límite para métodos regionNetworkEndpointGroups.attachNetworkEndpoints y regionNetworkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_write_requests_per_region RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150
Solicitudes de listas de extremos de red regionales
Cuota para el método regionNetworkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_list_requests_per_region RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500

Solicita un aumento de las cuotas de frecuencia

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 consola de Google Cloud. Para obtener más información, consulta Solicita un límite de cuota más alto.

Prácticas recomendadas

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

¿Qué sigue?