Comment puis-je éviter les erreurs « ThrottlingException » qui indiquent « Rate exceeded » (Dépassement du taux) lorsque j'utilise Parameter Store ?

Brève description

Les appels d'API Parameter Store ne peuvent pas dépasser le taux de requêtes d'API maximum autorisé pour chaque compte et chaque région AWS. Le taux maximum autorisé inclut les appels d'API provenant à la fois de l'interface de la ligne de commande AWS (AWS CLI) et de la console de gestion AWS.

Si les requêtes d'API dépassent le débit maximum, un message d'erreur similaire à l'un des exemples de message suivants peut s'afficher :

• « An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded »
• « An error occurred (ThrottlingException) when calling the GetParameter operation (reached max retries: 4): Rate exceeded »
• « An error occurred (ThrottlingException) when calling the GetParametersByPath operation (reached max retries: 4): Rate exceeded »
• « An error occurred (ThrottlingException) when calling the DescribeParameters operation (reached max retries: 2): Rate exceeded »

Résolution

Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l’interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre les erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l'AWS CLI.

Résoudre les erreurs

Pour éviter les messages d'erreur « ThrottlingException » qui incluent « Rate exceeded » (Dépassement du taux), procédez comme suit :

• Réduisez la fréquence des appels d'API.
• Configurez les intervalles des appels d'API afin qu'ils ne s'exécutent pas tous en même temps.
• Utilisez des API qui renvoient plusieurs valeurs. Par exemple, GetParameters et GetParametersByPath peuvent récupérer 10 paramètres en un seul appel d'API.
• Implémentez les nouvelles tentatives d'erreur et le backoff exponentiel lorsque vous effectuez des appels d'API.
• Si vous utilisez AWS Lambda pour appeler des API via Parameter Store, mettez vos paramètres en cache.

Augmenter le débit de Parameter Store

Si le message d'erreur « Rate exceeded » persiste après avoir effectué les actions de dépannage précédentes, augmentez le débit de Parameter Store. Pour plus d'informations sur le débit maximal par défaut et les quotas maximaux, consultez la section Quotas de service pour Parameter Store.

Important : lorsque vous augmentez le débit, votre compte est débité. Pour plus d'informations, consultez la section Tarification AWS Systems Manager.

Informations connexes

Backoff exponentiel et gigue

Résolution des problèmes liés au magasin de paramètres