Cotas de uso
Uma cota limita quantas vezes uma operação pode rodar dentro de uma janela móvel. Quem atinge o limite recebe a mensagem que você escreveu para aquela regra.
Regras na operação
As cotas são declaradas na config, na operação, como uma lista de regras. Uma regra define points, o máximo de execuções permitidas na janela, e duration, a duração da janela em segundos. Zero points significa ilimitado. A janela desliza: cada execução recebe um carimbo de tempo, e as execuções mais antigas que a duração saem da contagem.
De quem são as execuções contadas
Uma regra pode contar por usuário logado, de modo que cada pessoa tenha uma franquia própria. Uma cota também pode ser compartilhada em um grupo mais amplo.
No limite
A chamada falha com RATE_LIMITED e a mensagem da regra. Uma regra sem mensagem devolve um erro que informa o uso, o limite e o horário em que a janela é reiniciada.
Níveis a partir da ordem das regras
As regras são avaliadas de cima para baixo e a primeira que corresponde vence. Uma regra pode ser limitada aos membros de um segmento, o que dá uma configuração em níveis: uma regra ilimitada para um segmento de usuários pagantes, seguida de uma regra medida para todos os outros.
Ordem das verificações e falha
As cotas são verificadas depois que as pré-condições passam. Se o armazenamento do contador não puder ser lido, uma regra permite a chamada por padrão, e uma regra pode ser configurada para falhar fechada e recusar. Uma cota mede apenas operações.
Leia os detalhes
A referência de configuração de operações lista todos os campos de uma regra de cota e mostra o padrão em níveis.