Modelo de cuota de servicio

En esta página se describe el modelo de administración de cuotas de los servicios de Google Cloud. Comprenderlo facilita el uso de las funciones de administración de cuotas de Service Usage. Para obtener información general, consulta Trabaja con cuotas.

Un consumidor de un servicio es un proyecto, una carpeta o una organización a la que se le atribuye el uso del servicio.

Métricas y límites

Las métricas de cuota son entidades definidas por un servicio que representan el consumo del servicio. Una métrica de cuota podría contar entidades concretas, como instancias de máquinas virtuales, o podría contar entidades efímeras, como solicitudes a la API de un tipo específico.

Los límites de cuota son entidades definidas por un servicio que especifican cómo se limita el consumo de una métrica de cuota para un consumidor. Las métricas de cuota pueden tener varios límites de cuota. Hay dos tipos de límites de cuota: límites de frecuencia y límites de asignación. Los límites de frecuencia se restablecen después de un tiempo especificado, como un minuto o un día. Las cuotas de asignación no se restablecen con el tiempo; en su lugar, deben liberarse explícitamente cuando se deja de usar un recurso.

Anulaciones de cuotas

Cada límite de cuota tiene un valor predeterminado para todos los consumidores, establecido por el propietario del servicio. Una anulación de cuota puede cambiar este valor predeterminado.

El propietario del servicio puede aplicar una anulación de cuota a un consumidor específico para reemplazar el valor predeterminado de ese consumidor. Esto se denomina anulación del productor. Por ejemplo, un propietario del servicio podría aplicar una anulación del productor para otorgar una cuota elevada a un cliente específico como parte de un contrato.

El consumidor puede aplicar una anulación de cuota a su propio proyecto, carpeta u organización para limitar el uso que hace de un servicio, lo que se conoce como “anulación del consumidor”. Por ejemplo, un consumidor podría aplicar una anulación de consumo a su proyecto como medida de control de costos para no exceder el presupuesto.

Para aplicar una anulación del consumidor a un servicio que utilizas, usa la API de Service Usage.

Para aplicar una anulación del productor a un consumidor de uno de tus servicios, usa la API de Administración de consumidores de servicios.

Calcula el límite de cuota

La siguiente fórmula permite calcular el límite de cuota de un consumidor:

if adminOverride is present,
  upperBound = adminOverride
else if producerOverride is present,
  upperBound = producerOverride
else
  upperBound = defaultLimit

if consumerOverride is present,
  quotaLimit = min(consumerOverride, upperBound)
else
  quotaLimit = upperBound

Cuota regional y zonal

Un límite de cuota puede contarse globalmente o por separado en cada región o zona de Cloud.

Por ejemplo, supongamos que un servicio tiene un límite de cuota global de 100 solicitudes a la API por minuto. Si se realizan 80 solicitudes a la API en la región us-central1 y 70 en la región asia-northeast3, entonces se contarán 150 solicitudes en el límite global, y se rechazarán algunas solicitudes. Sin embargo, para un límite regional, cada región tiene su propia cuota de 100 solicitudes por minuto. Si se realizan 80 solicitudes en us-central1, no se excedería el límite de 100 solicitudes de esa región. Enviar 70 solicitudes en asia-northeast3 tampoco excedería el límite de 100 solicitudes de esa región, por lo que no se rechazaría ninguna solicitud.

Una anulación de cuota se puede aplicar a todas las regiones a la vez o a una región específica. Cuando se aplica una anulación a una región específica, no se ven afectados los límites efectivos de otras regiones.

Del mismo modo, se puede aplicar una anulación de cuota a todas las zonas a la vez o a una zona específica. Cuando se aplica una anulación a una zona específica, no se ven afectados los límites reales de otras zonas.