Comment puis-je résoudre les erreurs « 429 requêtes trop nombreuses » ou « limite dépassée » pour mon API Gateway ?

Description sommaire

API Gateway dispose de quotas au niveau du compte, par région. Le quota de régulation est de 10 000 requêtes par seconde (RPS) avec une capacité de débordement supplémentaire fournie par l'algorithme Token Bucket. La capacité maximale du bucket est de 5 000 demandes par compte et par région. Les paramètres liés à la régulation d'API Gateway sont appliqués dans l'ordre suivant :

• Limites de régulation par client ou par méthode que vous définissez pour une étape d'API dans un plan d'utilisation.
• Limites de régulation par méthode que vous définissez pour une étape d'API.
• Régulation au niveau du compte par région.
• Régulation régionale des services AWS.

Le dépassement de la limite ou du quota de régulation renvoie une réponse d'erreur « 429 requêtes trop nombreuses » ou « limite dépassée ».

Pour plus d'informations, veuillez consulter comment les paramètres de limite de régulation sont appliqués dans API Gateway.

Solution

Avant de commencer, assurez-vous d'avoir suivi les instructions pour activer Amazon CloudWatch Logs afin de résoudre les problèmes liés à API Gateway. Veillez à sélectionner ERROR pour générer des journaux d'exécution uniquement pour les demandes envoyées à votre API qui entraînent une erreur. Consultez ensuite les requêtes et les réponses d'API enregistrées à l'aide de la console CloudWatch.

Erreur « 429 requêtes trop nombreuses »

Vérifiez le débit ou la limite de rafale pour les limites de régulation par client ou par méthode que vous avez définies pour l'étape API de votre plan d'utilisation. Lorsque les limites de débit ou de rafale sont dépassées, l'exécution de CloudWatch enregistre une erreur de dépassement de la limite de régulation similaire à ce qui suit :

(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

Pour résoudre cette erreur, veuillez utiliser les nouvelles tentatives et un algorithme de backoff exponentiel avec gigue, puis soumettez à nouveau votre requête API.

Pour plus d'informations, consultez Backoff exponentiel et gigue.

Erreur « limite dépassée »

Cette erreur peut indiquer que la limite de quota est dépassée pour votre plan d'utilisation d'API Gateway. Lorsque la limite de quota est dépassée, l'exécution de CloudWatch enregistre une erreur de dépassement de limite de quota similaire à ce qui suit :

(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

Pour résoudre cette erreur, veuillez suivre les instructions pour prolonger le quota restant.

Informations connexes

Comment résoudre les problèmes de limitation de fonction Lambda avec des erreurs « Dépassement du débit » et « 429 TooManyRequestsException » ?

Comment trouver les erreurs d'API REST API Gateway dans mes journaux CloudWatch Logs ?