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 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/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
|
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 |
|
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 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/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
|
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 Google Cloud cobra el uso de la cuota para esta métrica, además de las cuotas en las métricas |
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?
- Obtén más información sobre el uso de la API de Monitoring.
- Obtén información para configurar alertas de cuota.