Modelo de cota de serviço

Nesta página, você verá a descrição do modelo de gerenciamento de cotas para serviços no Google Cloud. Entender esse modelo de cota é útil ao usar os recursos de gerenciamento de cotas do Service Usage. Para informações gerais, consulte Como trabalhar com cotas.

Um consumidor de um serviço é um projeto, uma pasta ou uma organização a que o uso do serviço é atribuído.

Métricas e limites

Uma métrica de cota é uma entidade definida por um serviço que considera o consumo dele. Uma métrica de cota pode contar entidades concretas como instâncias de máquina virtual ou contar entidades temporárias, como solicitações de API de um tipo específico.

Um limite de cota é uma entidade definida por um serviço que especifica como o consumo de uma métrica de cota é limitado para um consumidor. Uma métrica de cota pode ter vários limites de cota. Existem dois tipos de limites de cota: limites de taxa e limites de alocação. Um limite de taxa é redefinido após um período especificado, como um minuto ou um dia. A cota de alocação não é redefinida com o tempo. Em vez disso, ela precisa ser liberada explicitamente quando um recurso não é mais usado.

Modificações de cota

Cada limite de cota tem um valor padrão para todos os consumidores, definido pelo proprietário do serviço. Esse valor padrão pode ser alterado por uma modificação de cota.

O proprietário do serviço pode aplicar uma modificação de cota a um consumidor específico para substituir o valor padrão desse consumidor. Isso é chamado de modificação de produtor. Por exemplo, um proprietário do serviço pode aplicar uma substituição de produtor para atribuir uma cota mais alta a um cliente específico como parte de um contrato.

O consumidor pode aplicar uma modificação de cota ao próprio projeto, pasta ou organização para limitar o próprio uso de um serviço. Isso é chamado de modificação do consumidor. Por exemplo, um consumidor pode aplicar uma modificação ao próprio projeto como medida de controle de custos, para evitar que o orçamento seja excedido.

Para aplicar uma modificação de consumidor a um serviço que você consome, use a API Service Usage.

Para aplicar uma modificação de produtor a um consumidor de um serviço que você tem, use a API Service Consumer Management.

Como calcular o limite de cota

A fórmula a seguir calcula o limite de cota de um 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

Cota regional e por zona

Um limite de cota pode ser contabilizado globalmente ou de maneira separada em cada região ou zona do Cloud.

Por exemplo, suponha que um serviço tenha um limite de cota global de 100 solicitações de API por minuto. Se 80 solicitações de API forem feitas na região us-central1 e 70 solicitações forem feitas em asia-northeast3, 150 solicitações serão contabilizadas no limite global e algumas solicitações serão rejeitadas. No entanto, para um limite regional, cada região tem sua própria cota separada de 100 solicitações por minuto. Oitenta solicitações em us-central1 não excederiam o limite de 100 solicitações nessa região e 70 solicitações em asia-northeast3 também não excederiam o limite de 100 solicitações nessa região. Portanto, nenhuma solicitação seria rejeitada.

Uma modificação de cota pode ser aplicada a todas as regiões de uma só vez ou a uma região específica. Quando uma modificação é aplicada a uma região específica, os limites efetivos de outras regiões não são afetados.

Da mesma forma, uma modificação de cota pode ser aplicada a todas as zonas de uma só vez ou a uma zona específica. Quando uma modificação é aplicada a uma zona específica, os limites efetivos de outras zonas não são afetados.