En este documento, se enumeran las cuotas de frecuencia y los límites del sistema de Compute Engine que especifican la cantidad de solicitudes que puedes realizar a los métodos de la API de Compute Engine.
Las cuotas restringen la cantidad de un recurso de Google Cloud que puede usar tu proyecto. Si deseas cambiar el valor de tu cuota para permitir un mayor uso de recursos, puedes solicitar un ajuste de cuota. Los límites del sistema son restricciones fijas que no se pueden aumentar ni disminuir. Para obtener más información, consulta la descripción general de Cloud Quotas.
Cuotas de frecuencia y límites del sistema
Las cuotas de frecuencia (también conocidas como 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 en un intervalo por minuto para cada grupo. Si tu
proyecto alcanza la cantidad máxima de solicitudes a la API en 60 segundos, debes
esperar a que se vuelva a completar esa cuota de frecuencia antes de realizar más solicitudes en ese grupo.
Por ejemplo, si un proyecto alcanza un límite de cuota a las 10:00:15, la cuota se vuelve a llenar
al comienzo del siguiente intervalo sincronizado, como las 10:01:00, en lugar de
volver a llenarse de inmediato.
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 mediante las cuotas de la 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 y límites del sistema 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 y límites del sistema simplificados para métodos globales
Para mejorar la visibilidad y la 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 las métricas de cuota de la API de Compute Engine.
En la siguiente tabla, se enumeran las cuotas y métricas simplificadas de la API de Compute Engine:
| Cuota y descripción | Nombre de la métrica |
|---|---|
Solicitudes de lectura por minuto (GlobalReadsPerMinutePerProject)Cuota para los métodos globales get y list.
|
compute.googleapis.com/global_reads |
Solicitudes de escritura por minuto (GlobalWritesPerMinutePerProject)Cuota para los métodos de escritura globales que no están incluidos en otras métricas de cuota. |
compute.googleapis.com/global_writes |
Solicitudes de invalidación de caché por minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)Cuota para métodos UrlMapsService.InvalidateCache globales.
|
compute.googleapis.com/global_cache_invalidation_requests |
En la siguiente tabla, se enumeran los límites y las métricas del sistema para la API de Compute Engine:
| Límite y descripción del sistema | Nombre de la métrica |
|---|---|
Solicitudes de lista utilizables por minuto (GlobalListUsablePerMinutePerProject)Límite del sistema para los métodos ListUsable globales.
|
compute.googleapis.com/list_usable_requests |
Sobrecarga de costos de la lista filtrada (ListRequestsFilterCostOverheadPerMinutePerProject)Límite del sistema para
los métodos globales Google Cloud cobra el uso de la cuota para esta métrica, además de
las cuotas de
la métrica |
compute.googleapis.com/filtered_list_cost_overheadFrecuencia 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)Es el límite del sistema para todas las solicitudes de lectura y escritura globales. |
compute.googleapis.com/global_requests |
Cuotas de API heredadas y límites del sistema 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 y descripción | Nombre de la métrica |
|---|---|
Consultas por minuto (defaultPerMinutePerProject)Cuota para los métodos de mutación y lista globales que no están incluidos en otras métricas de cuota. Los siguientes métodos
|
compute.googleapis.com/default |
Solicitudes de lectura (heredadas) (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 lectura de operaciones (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 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 y 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 |
|
| 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 y límites del sistema 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 y límites de la API simplificados para métodos regionales y zonales
En la siguiente tabla, se enumeran las métricas de cuota de API 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 las métricas de cuota de la API de Compute Engine.
| Cuota y descripción | Nombre de la métrica |
|---|---|
Solicitudes de lectura por minuto por región (ReadRequestsPerMinutePerProjectPerRegion)Cuota 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 están incluidos en otras métricas de cuota. |
compute.googleapis.com/writes_per_region |
En la siguiente tabla, se enumeran los límites del sistema para los métodos regionales y zonales de la API de Compute Engine:
| Límite y descripción del sistema | Nombre de la métrica |
|---|---|
Enumera las solicitudes utilizables por región (ListUsablePerMinutePerProjectPerRegion)Límite del sistema para los métodos ListUsable regionales y zonales.
|
compute.googleapis.com/list_usable_requests_per_region |
| Sobrecosto de la lista filtrada por región Límite del sistema para
los métodos regionales y zonales Google Cloud cobra el uso de la cuota para esta métrica, además de
las cuotas de
la métrica |
compute.googleapis.com/filtered_list_cost_overhead_per_regionFrecuencia 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 el límite del sistema para todas las solicitudes de lectura y escritura regionales. |
compute.googleapis.com/requests_per_region |
Cuotas de API heredadas y límites del sistema 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 y descripción | 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 (heredadas) (ReadRequestsPerMinutePerRegion)Cuota para los 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 los métodos list regionales y zonales,
como autoscalers.list, disks.list, instances.list
y machineTypes.list. |
compute.googleapis.com/list_requests_per_region |
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 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 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 HeavyWeightWriteRequestsPerMinutePerProjectPerRegionCuota 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 InstanceListReferrersRequestsPerMinutePerProjectPerRegionCuota para el método instances.listReferrers. |
compute.googleapis.com/instance_list_referrers_requests_per_region |
Solicitudes de escritura de extremos de red NetworkEndpointWriteRequestsPerMinutePerProjectPerRegionCuota para los métodos networkEndpointGroups.attachNetworkEndpoints y networkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/network_endpoint_write_requests_per_region |
Solicitudes de listas 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 los métodos regionNetworkEndpointGroups.attachNetworkEndpoints
y regionNetworkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
Solicitudes de listas de extremos de red regionales (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)Cuota para el método regionNetworkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
En la siguiente tabla, se enumeran los límites del sistema heredados para los métodos regionales y zonales de la API de Compute Engine:
| Límite y descripción del sistema | Nombre de la métrica |
|---|---|
| Sobrecarga del costo de la lista filtrada Límite del sistema para los métodos Google Cloud cobra el uso de la cuota para esta métrica, además de
las cuotas de
las métricas |
compute.googleapis.com/filtered_list_cost_overhead_per_regionFrecuencia 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 .
|
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 instrucciones, consulta Solicita un ajuste de cuota.
Prácticas recomendadas
Sigue las prácticas recomendadas de la API de Compute Engine para conservar las cuotas de frecuencia y mitigar los efectos de las cuotas de frecuencia.
¿Qué sigue?
- Obtén más información para supervisar el uso de tu API.
- Obtén información para configurar alertas de cuota.