Como posso solucionar erros “429 Muitas solicitações” ou “Limite excedido” na minha API do API Gateway?

Data da última atualização: 26/09/2022

Recebi os erros “429 solicitações demais” ou “Limite excedido” ao enviar solicitações para minha API do Amazon API Gateway. Como corrigir esses erros?

Breve descrição

O API Gateway tem cotas em nível de conta, por região. A cota de controle de utilização é de 10.000 solicitações por segundo (RPS) com uma capacidade adicional de intermitência fornecida pelo algoritmo de bucket de token. A capacidade máxima do bucket é de 5.000 solicitações por conta e região. As configurações relacionadas ao controle de utilização do API Gateway são aplicadas na seguinte ordem:

Exceder o limite de controle de utilização ou a cota retorna uma resposta de erro “429 Muitas solicitações” ou “Limite excedido”.

Para obter mais informações, consulte Como configurações de controle de utilização são aplicadas no API Gateway.

Resolução

Antes de começar, certifique-se de ter seguido as instruções para ativar o Amazon CloudWatch Logs para solucionar problemas com o API Gateway. Certifique-se de escolher ERROR para gerar logs de execução somente para solicitações à sua API que resultarem em um erro. Em seguida, visualize as solicitações e as respostas de API registradas usando o console do CloudWatch.

Erro “429 Muitas solicitações”

Verifique a taxa ou o limite de intermitência para os limites de controle de utilização por cliente ou por método que você definiu para o estágio de API do seu plano de uso. Quando os limites de taxa ou intermitência são excedidos, a execução do CloudWatch registra um erro de limite de controle de utilização excedido semelhante ao seguinte:

(f277a0b4-2bcd-41b3-8e43-4de770663ffb) API Key 
**********************************
F0yrv6 exceeded throttle limit for API
 Stage rohkz08x02/dev: Key throttle limit exceeded for Usage Plan ID 
nnpegc, RestApi rohkz08x02, Stage dev, Resource f646q2, HttpMethod GET. 
Limit: 5.00 Burst: 10

Para resolver esse erro, use novas tentativas e um algoritmo de recuo exponencial com variação e, em seguida, reenvie sua solicitação de API.

Para obter mais informações, consulte recuo exponencial e variação.

Erro de “Limite excedido”

Esse erro pode indicar que o limite de cota foi excedido para seu plano de uso do API Gateway. Quando o limite de cota é excedido, a execução do CloudWatch registra um erro de limite de cota excedido semelhante ao seguinte:

(7b819c41-e0a0-433a-883e-bc461fd70fd6) API Key 
**********************************
F0yrv6 exceeded quota limit for API 
Stage rohkz08x02/dev: Key quota exhausted for Usage Plan ID nnpegc. Q
Limit: 500 Period: DAY

Para resolver esse erro, siga as instruções para estender a cota restante.