View a markdown version of this page

Limitation des demandes pour l'API Amazon RDS - Amazon Relational Database Service

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.

Limitation des demandes pour l'API Amazon RDS

Amazon RDS limite les demandes d'API pour chacun Compte AWS dans chaque AWS Région. Cela améliore les performances du service et garantit une utilisation équitable pour tous les clients Amazon RDS. La limitation garantit que les demandes adressées à l'API Amazon RDS ne dépassent pas les limites maximales autorisées. Les limites de demandes s'appliquent aux demandes d'API provenant de n'importe quelle source, y compris les suivantes.

  • Votre propre code d'application à l'aide d'un AWS SDK

  • Un outil de ligne de commande, tel que AWS CLI

  • Le Amazon RDS console

  • Un outil tiers qui utilise les informations d'identification de votre compte, tel qu'un outil d'infrastructure en tant que code ou de surveillance

Si vous utilisez des opérations d'API Amazon RDS et que vous dépassez la limite par défaut pour le nombre d'appels par seconde, l'API Amazon RDS émet une erreur similaire à la suivante.

ClientError: Une erreur s'est produite (ThrottlingException) lorsque vous appelez le API_name fonctionnement : Dépassement du taux.

Cette erreur signifie que votre compte a dépassé sa limite de requêtes d'API. Par défaut, vous pouvez effectuer jusqu'à 300 demandes en rafale et 12 demandes soutenues par seconde. Pour éviter cette erreur, réessayez la demande avec un retard exponentiel, réduisez votre taux de demandes ou demandez une augmentation de la limite. Pour plus d’informations, consultez Réessais et retard exponentiel, Réduire le nombre de demandes d'API et Demander une augmentation de limite.

Comment l'étranglement est-il appliqué

Amazon RDS utilise un compartiment de jetons pour limiter les demandes d'API. Comprendre le fonctionnement du bucket vous permet de prévoir à quel moment la limitation se produit et de planifier votre taux de demandes.

Votre compte est doté d'un seau qui contient un certain nombre de jetons. Chaque demande dépense un jeton, et Amazon RDS réajoute des jetons à un rythme régulier. Le nombre de jetons dans le compartiment correspond au nombre de demandes que vous pouvez effectuer à ce moment-là.

Votre compte comporte un compartiment pour chaque AWS Région, partagée par toutes les actions de l'API Amazon RDS. Chaque requête que vous effectuez supprime un jeton du compartiment. Supposons que la taille du seau soit de 300 jetons. Vous pouvez effectuer jusqu'à 300 demandes en une seconde. Si vous dépassez 300 demandes en une seconde, vous êtes limité et les demandes restantes au cours de cette seconde échouent.

Les seaux se rechargent automatiquement à un taux défini. Si le compartiment est inférieur à sa capacité maximale, Amazon RDS y ajoute un nombre défini de jetons chaque seconde jusqu'à ce qu'il atteigne sa capacité maximale.

Si le seau est plein à l'arrivée des jetons de recharge, le seau les jette. Le compartiment ne peut pas contenir plus que son nombre maximum de jetons.

Supposons que la taille du seau soit de 300 jetons et que le taux de recharge soit de 12 jetons par seconde. Si vous effectuez 300 demandes en une seconde, le compartiment tombe à zéro (0) jeton.

Le seau se remplit ensuite de 12 jetons par seconde. Il atteint sa capacité maximale de 300 jetons après 25 secondes si vous ne faites aucune demande pendant cette période.

Vous n'avez pas besoin d'attendre que le compartiment soit complètement plein pour pouvoir effectuer des requêtes d'API. Vous pouvez utiliser des jetons de recharge lorsqu'ils sont ajoutés au seau. Si vous épuisez le compartiment en effectuant 300 demandes par seconde, vous pouvez continuer à effectuer 12 demandes par seconde en utilisant les jetons de recharge au fur et à mesure qu'ils sont ajoutés au compartiment. Le seau ne peut être rempli à sa capacité maximale que si vous faites moins de 12 demandes par seconde.

Amazon RDS limite séparément les demandes qui AWS des services, tels que AWS CloudFormation, faites en votre nom. Ces demandes ne consomment pas de jetons provenant du compartiment de votre compte.

Taille du seau à jetons et taux de remplissage

Le tableau suivant indique les limites de limitation des demandes d'API par défaut pour chaque Compte AWS dans chaque AWS Région.

Actions d’API Capacité maximale du compartiment Taux de remplissage du compartiment (par seconde)
Tous Actions de l'API Amazon RDS 300 12

Il s'agit des limites par défaut. Si AWS a augmenté les limites de votre compte, vos limites sont plus élevées.

Pour plus d'informations sur les quotas relatifs au nombre de ressources Amazon RDS que vous pouvez créer dans votre compte, consultez Quotas en Amazon RDS. Pour plus d'informations sur les points de terminaison et les quotas des services Amazon RDS, consultez Points de terminaison et quotas Amazon Relational Database Service dans le Référence générale d'Amazon Web Services.

Réessais et retard exponentiel

Il se peut que votre application doive réessayer une demande d'API. Par exemple :

  • Pour vérifier la mise à jour de l'état d'une ressource, telle qu'une instance de base de données en cours de création ou de modification

  • Pour énumérer un grand nombre de ressources (par exemple, tous vos instantanés de base de données)

  • Pour réessayer une demande après qu'elle a échoué en raison d'une erreur de serveur (5xx) ou d'une erreur de limitation

Toutefois, en cas d'erreur client (4xx) autre qu'une erreur de limitation, révisez la demande pour corriger le problème avant de recommencer.

Changements d'état des ressources

Avant de commencer à interroger pour vérifier les mises à jour de statut, donnez à la demande le temps de terminer éventuellement. Par exemple, attendez quelques minutes avant de vérifier si votre instance de base de données est disponible. Lorsque vous commencez à interroger, utilisez un intervalle de veille approprié entre les demandes successives afin de réduire le taux de demandes d'API. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant ou variable.

Vous pouvez également utiliser Amazon EventBridge pour vous informer de l'état de vos ressources au lieu de les interroger. Par exemple, vous pouvez recevoir un événement lorsqu'une instance de base de données devient disponible ou lorsqu'un instantané se termine. Pour plus d’informations, consultez Création d'une règle qui se déclenche sur un Amazon RDS event.

Nouvelle tentative

Lorsque vous devez interroger ou réessayer une demande d'API, utilisez un algorithme d'attente exponentiel pour calculer l'intervalle de veille entre les demandes. Attendez de plus en plus longtemps entre les nouvelles tentatives. Définissez un délai maximum et un nombre maximum de tentatives. Ajoutez de la gigue (délai aléatoire) pour éviter les collisions successives. Pour obtenir des conseils de mise en œuvre, voir Délais d'attente, nouvelles tentatives et arrêts avec gigue sur le AWS Site web de la bibliothèque des constructeurs.

Chaque AWS Le SDK implémente une logique de nouvelle tentative automatique et recommence ThrottlingException erreurs par défaut. Pour plus d'informations, voir Comportement des nouvelles tentatives dans le AWS Guide de référence des kits de développement logiciel et des outils.

Réduire le nombre de demandes d'API

Comme toutes les actions d'API partagent un compartiment, la réduction des demandes émanant de n'importe quel appelant libère de la capacité pour tous les autres appelants de votre compte. Avant de demander une augmentation de limite, tenez compte des points suivants.

Réponses en cache

Informations renvoyées par Describe* des actions, telles que DescribeDBInstances et DescribeDBClusters, change généralement peu fréquemment. Mettez les résultats en cache et réutilisez-les au lieu d'appeler l'API chaque fois que vous avez besoin des informations.

Limitez votre taux de demandes côté client

Adaptez votre taux de demandes sortantes pour qu'il reste inférieur au taux soutenu avant d'envoyer des demandes, plutôt que de vous fier aux nouvelles tentatives après la limitation.

Remplacer les sondages par des événements

Utilisez Amazon EventBridge pour être informé des changements d'état des ressources au lieu d'appeler à plusieurs reprises Describe* actions.

Ne demandez que ce dont vous avez besoin

Spécifiez un identifiant ou utilisez Filters paramètre de sorte qu'un Describe* action renvoie uniquement les ressources qui vous intéressent et parcourt de grands ensembles de résultats avec MaxRecords et Marker.

Répartissez les demandes planifiées

Si de nombreux travailleurs, tâches planifiées ou agents de surveillance appellent l'API au même moment, ajoutez un délai aléatoire à chacun afin que les demandes soient étalées dans le temps au lieu d'arriver en rafale.

Identifier la source des requêtes limitées

AWS CloudTrail enregistre chaque demande d'API sur votre compte. Chaque enregistrement vous indique qui a fait la demande, quel outil l'a faite et si elle a abouti. Utiliser AWS CloudTrail pour identifier les utilisateurs, les rôles ou les outils qui répondent le plus à vos demandes. Pour plus d'informations sur la journalisation AWS CloudTrail , consultez Surveillance des appels AWS CloudTrail.

Afficher les limites actuelles de vos API

Service Quotas ne gère pas les limites de limitation des API Amazon RDS et celles-ci n'apparaissent pas dans la console Service Quotas. À moins que AWS a augmenté les limites de votre compte, les limites par défaut s'appliquent. Si votre compte a été augmenté et que vous ne connaissez pas vos limites actuelles, ouvrez un dossier d'assistance pour les confirmer.

Demander une augmentation de limite

Vous pouvez demander une augmentation des limites de limitation des API pour votre Compte AWS en ouvrant un étui de support. L'augmentation des limites ne se fait pas en libre-service, et AWS ne les approuve pas automatiquement. AWS examine votre demande et votre trafic récent avant d'appliquer une nouvelle limite. Prévoyez du temps pour la révision et l'entrée en vigueur de la nouvelle limite.

Recommandations

Prenez en compte les recommandations suivantes avant de demander une augmentation.

  • Basez votre demande sur votre taux de demande de pointe mesuré. AWS examine votre modèle de trafic avant d'approuver une augmentation.

  • Donnez la priorité à l'augmentation du taux de remplissage des godets si vous êtes limité en cas de trafic soutenu. Augmentez la capacité maximale du godet si vous êtes étranglé pendant de courtes périodes.

  • Répartissez les tâches planifiées ou les groupes de travailleurs qui commencent en même temps avant de demander une augmentation. L'étalement des requêtes permet généralement de résoudre le problème sans augmenter la limite.

  • Soumettez les demandes relatives à des événements planifiés, tels qu'une migration ou un déploiement de grande envergure, bien avant l'événement.

Soumettre une demande de support.

Si vous avez encore besoin d'une limite plus élevée après avoir examiné les recommandations, créer un dossier dans AWS Console du centre de support. Si vous n'avez jamais créé de dossier auparavant, consultez Création de dossiers d'assistance et gestion de cas dans le AWS Guide de l'utilisateur du support.

Pour accélérer l'examen, copiez le modèle suivant dans la description du dossier. Remplacer account_id, region, et les autres valeurs avec vos propres informations :

Please increase the Amazon RDS API throttling limits for my account. Account ID(s): account_id Region(s): region Description: use_case API actions: api_actions Time window: time_window Changes already made: changes_made Requested limits: Bucket maximum capacity: current_bucket_capacity -> requested_bucket_capacity Bucket refill rate: current_refill_rate -> requested_refill_rate

Le modèle utilise les valeurs suivantes.

account_id

Le Compte AWS Identifiant ou identifiants nécessitant une augmentation.

region

Le AWS Région ou régions où vous êtes limité.

use_case

Votre cas d'utilisation et les outils qui appellent l'API Amazon RDS, tels que votre application, le AWS CLI, un outil d'infrastructure en tant que code ou un agent de surveillance.

api_actions

Les actions de l'API Amazon RDS qui génèrent la plupart de vos demandes.

time_window

Une fenêtre d'une heure, en UTC, pendant laquelle vous avez constaté un pic de limitation ou d'utilisation. Pour un événement planifié, les dates de début et de fin prévues.

changes_made

Tout ce que vous avez déjà essayé pour réduire le nombre de demandes, comme les nouvelles tentatives avec un retard exponentiel, la mise en cache ou des interrogations moins fréquentes.

current_bucket_capacity, requested_bucket_capacity

Capacité maximale de votre bucket actuelle et demandée (rafale).

current_refill_rate, requested_refill_rate

Votre taux de remplissage actuel et demandé, en demandes par seconde (continu).

Plus vous fournissez de contexte à propos de votre trafic, plus vite AWS peut trouver la limite qui vous convient.