Comment puis-je éviter les erreurs « ThrottlingException » qui indiquent « Rate exceeded » 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 messages 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 »

Pour améliorer les performances du service, les requêtes de stockage des paramètres sont limitées pour chaque compte et chaque région. Pour plus d'informations sur les quotas de débit maximum de l'API Parameter Store, consultez la section Quotas de service.

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes 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ésolution des problèmes

Pour éviter les messages d'erreur « ThrottlingException » qui incluent « Rate exceeded », 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.
• Augmentez le débit de 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.

Demander une augmentation du quota de service

Si vous avez essayé toutes les méthodes de résolution précédentes mais que vous recevez toujours le message d'erreur « Rate exceeded », vous pouvez demander une augmentation du quota de service.

Remarque : Avant de soumettre une requête, identifiez l'appel d'API et le taux d'appels.

Pour demander une augmentation du quota de service pour Parameter Store, procédez comme suit :

1. Ouvrez la console du centre AWS Support, puis sélectionnez Créer un cas.
2. Sélectionnez Vous recherchez une augmentation des limites de service ?.
3. Pour Type de limite, sélectionnez EC2 Systems Manager.
4. Pour Région, choisissez votre région AWS sous Requêtes.
5. Pour Type de ressource, sélectionnez Parameter Store.
6. Saisissez la nouvelle valeur du quota.
7. Dans la zone de texte Description du cas d'utilisation, incluez la période liée au problème de limitation et le motif de la requête d'augmentation du quota.
8. Choisissez vos options de contact préférées, puis sélectionnez Soumettre.

Renseignement connexes

Backoff exponentiel et gigue

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