Identificar o limite atingido
HTTP 429 indica pedidos em excesso e pode incluir Retry-After. A contagem e o âmbito dependem do serviço. Uma média baixa não impede ultrapassar uma janela curta.
| Conceito | O que limita | Ação útil |
|---|---|---|
| Quota | Volume num período | Planear o orçamento partilhado. |
| Ritmo | Chegadas numa janela curta | Distribuir os inícios. |
| Concorrência | Operações em curso | Limitar trabalho simultâneo. |
| Retry-After: 120 | Espera de 120 segundos | Verificar prazo total e segurança da repetição. |
Organizar a procura autorizada
- Confirme a chave de contagem: conta, projeto, utilizador ou rota. Verifique fuso de reposição, custo por operação e orçamento partilhado.
- Suavize rajadas com fila limitada e limite separadamente operações em curso. Propague cancelamentos e descarte trabalho já inútil.
- Interprete Retry-After como data HTTP ou espera em segundos. Respeite-o dentro do prazo global e defina espera limitada se estiver ausente.
Avaliar sem contornar proteções
429 não prova que repetir a operação seja seguro. Verifique idempotência, tempo e tentativas. Meça recusas e fila; se a procura sustentada superar o contrato, reduza necessidades ou acorde capacidade adequada.
Fontes primárias
Tornar observável o abuso do limite de taxa.
Os limites de requisição funcionam melhor quando distinguem o uso legítimo do comportamento anormal e produzem um evento interpretável. Códigos de erro isolados podem ocultar o início, a duração e o alcance de um padrão de abuso.
- Registrar o limite, a decisão, a rota e o contexto mínimo sem segredos.
- Correlacionar negativas repetidas com os efeitos sobre os usuários legítimos.
- Testar se os alertas levam a investigações ou ajustes proporcionais.
Fonte primária: ACSC and partners — Event logging and threat detection. Método relacionado: consultar o guia prático.