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.
# Gérer la limitation des demandes d' AWS Cloud Map DiscoverInstances API
AWS Cloud Map limite les demandes [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)d'API pour chaque AWS compte par région. Le throttling contribue à améliorer les performances du service et à garantir une utilisation équitable pour tous les AWS Cloud Map clients. La régulation garantit que les appels à l' AWS Cloud Map [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API ne dépassent pas les quotas de demandes d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API maximaux autorisés. [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) Les appels d'API provenant de l'une des sources suivantes sont soumis aux quotas de demandes :
+ Une application tierce
+ Un outil de ligne de commande
+ La AWS Cloud Map console
Si vous dépassez le quota de limitation de l'API, le code `RequestLimitExceeded` d'erreur s'affiche. Pour de plus amples informations, veuillez consulter [Limitation du débit de demande](#throttling-rate-based).
## Comment l'étranglement est appliqué
AWS Cloud Map utilise l'[algorithme Token Bucket](https://en.wikipedia.org/wiki/Token_bucket) pour implémenter la régulation des API. Avec cet algorithme, votre compte dispose d'un *compartiment* contenant un nombre spécifique de *jetons*. Le nombre de jetons dans le compartiment représente votre quota de limitation à chaque seconde. Il existe un compartiment pour une seule région, qui s'applique à tous les points de terminaison de la région.
### Limitation du débit de demande
Le throttling limite le nombre de demandes d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API que vous pouvez effectuer. Chaque demande supprime un jeton du bucket. Par exemple, la taille du bucket pour l'opération d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API est de 2 000 jetons, vous pouvez donc effectuer jusqu'à 2 000 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)demandes en une seconde. Si vous dépassez 2 000 demandes en une seconde, vous êtes limité et les demandes restantes au cours de cette seconde échouent.
Les seaux se rechargent automatiquement à un débit défini. Si le compartiment n'est pas à pleine capacité, un nombre défini de jetons est ajouté chaque seconde jusqu'à ce que le compartiment atteigne sa capacité maximale. Si le compartiment est plein à l'arrivée des jetons de recharge, ces jetons sont jetés. La taille du bucket pour le fonctionnement de l'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API est de 2 000 jetons et le taux de recharge est de 1 000 jetons par seconde. Si vous effectuez 2 000 demandes d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API par seconde, le bucket est immédiatement réduit à zéro (0) jeton. Le seau est ensuite rempli de 1 000 jetons par seconde jusqu'à ce qu'il atteigne sa capacité maximale de 2 000 jetons.
Vous pouvez utiliser des jetons au fur et à mesure qu'ils sont ajoutés au bucket. Il n'est pas nécessaire d'attendre que le compartiment atteigne sa capacité maximale avant de faire des demandes d'API. Si vous épuisez le compartiment en effectuant 2 000 demandes d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API en une seconde, vous pouvez toujours effectuer jusqu'à 1 000 demandes d'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API par seconde aussi longtemps que nécessaire. Cela signifie que vous pouvez immédiatement utiliser les jetons de recharge lorsqu'ils sont ajoutés à votre bucket. Le bucket ne commence à se recharger à sa capacité maximale que lorsque vous faites moins de demandes d'API par seconde que le taux de recharge.
### Nouvelles tentatives ou traitement par lots
Si une demande d'API échoue, il se peut que votre application doive réessayer la demande. Pour réduire le nombre de demandes d'API, utilisez un intervalle de sommeil approprié entre les demandes successives. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant ou variable.
### Calcul de l’intervalle de veille
Lorsque vous devez interroger ou relancer une demande d’API, nous vous recommandons d’utiliser un algorithme d’interruption exponentielle pour calculer l’intervalle de sommeil entre les appels d’API. En utilisant des temps d'attente de plus en plus longs entre les tentatives pour des réponses d'erreur consécutives, vous pouvez réduire le nombre de demandes ayant échoué. Pour plus d'informations et des exemples d'implémentation de cet algorithme, voir [Retry Behavior](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) dans le *guide de référence AWS SDKs and Tools*.
## Ajustement des quotas de limitation des API
Vous pouvez demander une augmentation des quotas de limitation des API pour votre AWS compte. Pour demander un ajustement de quota, contactez[AWS Support Center](https://console.aws.amazon.com/support/home#/).