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.

Handle AWS Cloud Map DiscoverInstances Limitation des requêtes d'API

AWS Cloud Map limite les demandes DiscoverInstances d'API pour chaque AWS compte par région. Throttling contribue à améliorer les performances du service et à fournir une utilisation équitable pour tous les AWS Cloud Map clients. La limitation garantit que les appels à l' AWS Cloud Map DiscoverInstancesAPI ne dépassent pas les quotas de demandes d'DiscoverInstancesAPI maximum autorisés. DiscoverInstances Les appels d'API provenant de l'une des sources suivantes sont soumis aux quotas de demandes :

Si vous dépassez un quota de limitation de l'API, vous obtenez le code RequestLimitExceeded d'erreur. Pour plus d’informations, consultez Limitation du débit de demande.

Comment l'étranglement est-il appliqué ?

AWS Cloud Map utilise l'algorithme de bucket de jetons pour implémenter la limitation 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 d'étranglement à une seconde donnée. Il existe un compartiment pour une seule région et il s'applique à tous les points de terminaison de la région.

Limitation du débit de demande

La limitation limite le nombre de requêtes d'DiscoverInstancesAPI que vous pouvez effectuer. Chaque demande supprime un jeton du compartiment. Par exemple, la taille du compartiment pour l'opération d'DiscoverInstancesAPI est de 2 000 jetons, vous pouvez donc effectuer jusqu'à 2 000 DiscoverInstances requêtes 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 taux 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 seau est plein lorsque les jetons de recharge arrivent, ces jetons sont jetés. La taille du compartiment pour l'opération de l'DiscoverInstancesAPI est de 2 000 jetons et le taux de recharge est de 1 000 jetons par seconde. Si vous effectuez 2 000 demandes d'DiscoverInstancesAPI en une seconde, le compartiment 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 pour effectuer des demandes d'API. Si vous épuisez le compartiment en effectuant 2 000 demandes d'DiscoverInstancesAPI en une seconde, vous pouvez toujours effectuer jusqu'à 1 000 demandes d'DiscoverInstancesAPI par seconde aussi longtemps que nécessaire. Cela signifie que vous pouvez utiliser immédiatement les jetons de recharge au fur et à mesure qu'ils sont ajoutés à votre seau. Le compartiment ne commence à se remplir à sa capacité maximale que lorsque vous effectuez 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. Pour réduire le nombre de demandes d'API, utilisez un intervalle de veille 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 nouvelles tentatives pour les réponses d'erreur consécutives, vous pouvez réduire le nombre de demandes échouées. Pour plus d'informations et des exemples d'implémentation de cet algorithme, consultez Retry Behavior dans le Guide de référence AWS des kits de développement logiciel et des outils.

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, contactezAWS Support Center.