Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Limitez les requêtes adressées à vos API HTTP pour un meilleur débit dans API Gateway

Vous pouvez configurer la limitation pour vos API pour éviter qu'elles soient submergées de demandes. Les limitations sont appliquées dans la mesure du possible et doivent être considérées comme des cibles plutôt que des plafonds de demandes garantis.

API Gateway régule les demandes de limitations soumises à votre API à l'aide de l'algorithme de compartiment de jetons, où un jeton compte pour une demande. En particulier, API Gateway examine le taux de soumissions de demandes à un débit régulier et en mode rafale pour toutes les API de votre compte, par région. Dans l'algorithme de compartiment de jetons, une rafale peut permettre un dépassement prédéfini de ces limites, mais d'autres facteurs peuvent également entraîner le dépassement des limites dans certains cas.

Lorsque les soumissions de demandes dépassent les limites de taux régulier et en mode rafale des demandes, API Gateway commence à limiter les demandes. Les clients peuvent recevoir des réponses aux erreurs 429 Too Many Requests à ce stade. Lors de la capture de ces exceptions, le client peut renvoyer les demandes en échec de façon à limiter le débit tout en respectant les limitations.

En tant que développeur d'API, vous pouvez définir les limites pour les étapes ou acheminements d'API individuels afin d'améliorer les performances globales de toutes les API de votre compte.

Limitation au niveau du compte par région

API Gateway limite par défaut les demandes régulières par seconde (rps) pour toutes les API d'un compte AWS , par Région. Il limite également la rafale (c'est-à-dire, la taille maximale de compartiment) sur toutes les API au sein d'un compte AWS , par région. Dans API Gateway, la limite en mode rafale correspond au nombre maximal d'envois de demandes simultanés qu'API Gateway peut traiter à tout moment sans renvoyer de réponses d'erreur 429 Too Many Requests. Pour plus d'informations sur les quotas de limitation, consultez Quotas Amazon API Gateway et remarques importantes.

Les limites par compte sont appliquées à toutes les API d'un compte dans une région spécifiée. La limite du taux au niveau du compte peut être augmentée à la demande. Des limitations plus élevées sont possibles avec des API qui ont des délais d'attente plus courts et des charges utiles plus petites. Pour demander une augmentation des limitations au niveau du compte par Région, contactez le Centre de support AWS. Pour plus d’informations, consultez Quotas Amazon API Gateway et remarques importantes. Notez que ces limites ne peuvent pas être supérieures aux limites d' AWS étranglement.

Limitation au niveau de l’acheminement

Vous pouvez définir une limitation au niveau des acheminements, afin de remplacer les limitations de requêtes au niveau du compte pour une étape spécifique ou pour des acheminements particuliers de votre API. Les limites de limitation d'acheminement par défaut ne peuvent pas dépasser les limites de débit au niveau du compte.

Vous pouvez configurer la limitation au niveau des acheminements à l'aide de AWS CLI. La commande suivante configure la limitation personnalisée pour l'étape et l’acheminement spécifiés d'une API.

aws apigatewayv2 update-stage \
    --api-id a1b2c3d4 \
    --stage-name dev \
    --route-settings '{"GET /pets":{"ThrottlingBurstLimit":100,"ThrottlingRateLimit":2000}}'