View a markdown version of this page

Résolution des problèmes Parameter Store - AWS Systems Manager
Résolution des problèmes de débitRésolution des problèmes liés à la création du paramètre aws:ec2:image

• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la documentation Amazon CloudWatch Dashboard.

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.

Résolution des problèmes Parameter Store

Consultez les informations suivantes pour tenter de résoudre les problèmes liés à Parameter Store.

Résolution des problèmes de débit

Utilisez les informations suivantes pour résoudre les problèmes de débit dansParameter Store. Pour plus d'informations sur les quotas de débit et sur les raisons de la limitation, consultez. Optimisation du débit dans Parameter Store

L'application reçoit ThrottlingException ou commet RateExceeded des erreurs

Problème  : les journaux de votre application ou CloudWatch les journaux affichent une erreur telle que la suivante lors d'un appel GetParameterGetParameters, ou GetParametersByPath :

An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded

  • Solution  : Cette erreur signifie que votre taux d'appels combiné pour ces actions d'API a dépassé le quota de débit de votre compte pour le moment Région AWS. Effectuez une ou plusieurs des actions suivantes :

    • Réduisez la fréquence des appels de votre candidatureParameter Store. Mettez en cache les valeurs des paramètres dans votre application au lieu de les récupérer à chaque appel ou requête.

      Pour plus d'informations, consultez Parameters and Secrets Lambda Extension et Utilisation de l'extension Lambda AWS Parameter and Secrets pour mettre en cache les paramètres et les secrets.

    • Permet GetParameters de récupérer plusieurs noms de paramètres connus en un seul appel, plutôt que d'émettre des GetParameter appels séparés ou un GetParametersByPath appel.

    • Stagger lit lorsque de nombreuses instances, conteneurs ou fonctions démarrent en même temps, par exemple lors d'un déploiement ou d'un événement de dimensionnement.

    • Si votre application utilise des modèles de requêtes efficaces et continue de générer des erreurs de limitation, activez un débit plus élevé pour votre compte et. Région AWS Vous pouvez activer et désactiver un débit plus élevé à tout moment. Le coût est déterminé en fonction de l'utilisation. Pour plus d’informations, consultez Tarification d’AWS Systems Manager pour Parameter Store.

La limitation se produit uniquement lors des appels DescribeParameters

Problème  : Votre application reçoit un ThrottlingException message d'erreur lors DescribeParameters des appels, même si les GetParameter GetParameters vôtres, et GetParametersByPath les appels ne dépassent pas le quota.

  • Solution  : DescribeParameters possède une limite de débit distincte de celle des autres actions de récupération de paramètres : 3 TPS par défaut, ou 10 TPS avec un débit plus élevé activé. Le fait de passer moins d'GetParameterGetParametersByPathappels ou de passer moins d'appels n'a aucune incidence sur cette limite. GetParameters

    Une cause fréquente est l'appel DescribeParameters avec un filtre sur un compte comportant un grand nombre de paramètres. L'API pagine tous les paramètres du compte avant d'appliquer le filtre. Les comptes comportant de nombreux paramètres peuvent dépasser le DescribeParameters quota même lorsque le jeu de résultats filtré est faible.

    Dans la mesure du possibleGetParametersByPath, utilisez-le selon une hiérarchie spécifique plutôt qu'DescribeParametersavec un filtre. Vous pouvez également réduire la fréquence des DescribeParameters appels dans les scripts et les automatisations qui s'exécutent selon un calendrier.

Aucune erreur d'étranglement, mais la latence augmente pendant les déploiements

Problème  : aucune ThrottlingException erreur ne s'affiche dans vos journaux, mais votre application connaît une latence élevée ou des pannes intermittentes lors des déploiements, des redémarrages ou des événements de dimensionnement.

  • Solution  : Si votre application ou votre SDK réessaie automatiquement les requêtes limitées, une nouvelle tentative peut réussir sans jamais provoquer d'erreur de limitation. Si votre latence augmente, vérifiez le nombre de tentatives dans les journaux ou les statistiques de votre SDK. Un nombre de nouvelles tentatives d'Parameter Storeappel différent de zéro lors de ces événements indique que vous approchez de votre quota de débit, même sans échec. Appliquez les mêmes techniques d'optimisation décrites dans Optimisation du débit dans Parameter Store pour réduire les nouvelles tentatives avant qu'elles ne se transforment en échecs.

Résolution des problèmes liés à la création du paramètre aws:ec2:image

Utilisez les informations suivantes pour résoudre les problèmes liés à la création de paramètres de type de données aws:ec2:image.

Pas d’autorisation pour créer une instance

Problème : vous essayez de créer une instance à l’aide d’un paramètre aws:ec2:image, mais vous recevez un message d’erreur tel que « Vous n’êtes pas autorisé à effectuer cette opération. »

  • Solution : vous ne disposez pas de toutes les autorisations nécessaires pour créer une instance EC2 à l’aide d’une valeur de paramètre, telles que les autorisations pour ec2:RunInstances, ec2:DescribeImages et ssm:GetParameter, entre autres. Contactez un utilisateur disposant des autorisations d'administrateur dans votre organisation pour demander les autorisations nécessaires.

EventBridge signale le message d'échec « Impossible de décrire la ressource »

Problème : vous avez exécuté une commande pour créer un paramètre aws:ec2:image, mais la création de ce dernier a échoué. Vous recevez une notification d'Amazon EventBridge signalant l'exception « Impossible de décrire la ressource ».

Solution : ce message peut indiquer ce qui suit :

  • Vous n'avez pas reçu l'autorisation requise pour l'opération d'API ec2:DescribeImages, ou vous n'avez pas l'autorisation d'accéder à l'image spécifique référencée dans le paramètre. Contactez un utilisateur disposant des autorisations d'administrateur dans votre organisation pour demander les autorisations nécessaires.

  • L'ID d'Amazon Machine Image (AMI) que vous avez saisi en tant que valeur de paramètre n'est pas valide. Assurez-vous de saisir l'identifiant d'un AMI utilisateur disponible sur le compte actuel Région AWS sur lequel vous travaillez.

Le nouveau paramètre aws:ec2:image n'est pas disponible

Problème : vous venez d'exécuter une commande pour créer un paramètre aws:ec2:image et un numéro de version a été signalé, mais le paramètre n'est pas disponible.

  • Solution : lorsque vous exécutez la commande pour créer un paramètre qui utilise le type de données aws:ec2:image, un numéro de version est immédiatement généré pour le paramètre, mais le format de ce dernier doit être validé avant qu'il ne soit disponible. Ce processus peut prendre quelques minutes. Pour surveiller le processus de création et de validation des paramètres, vous pouvez faire ce qui suit :

    • Utilisez-le EventBridge pour vous envoyer des notifications concernant vos opérations create et celles relatives aux update paramètres. Ces notifications indiquent si une opération de paramètre a réussi ou non. Pour plus d'informations sur l'abonnement aux Parameter Store événements de EventBridge, consultezConfiguration des notifications ou déclenchement d'actions en fonction de Parameter Store events.

    • Dans la section Parameter Store de la console Systems Manager, mettez à jour périodiquement la liste des paramètres pour rechercher les détails des nouveaux paramètres ou de ceux mis à jour.

    • Utilisez la commande GetParameter pour vérifier le nouveau paramètre ou le paramètre mis à jour. Par exemple, en utilisant l' AWS Command Line Interface (AWS CLI) :

      aws ssm get-parameter name MyParameter

      Pour un nouveau paramètre, un message ParameterNotFound est renvoyé jusqu'à ce que le paramètre soit validé. Pour un paramètre existant que vous mettez à jour, les informations sur la nouvelle version ne sont pas incluses tant que le paramètre n'est pas validé.

    Si vous tentez de créer ou de mettre à jour à nouveau le paramètre avant la fin du processus de validation, le système signale que la validation est toujours en cours. Si le paramètre n'est pas créé ou mis à jour, vous pouvez réessayer 5 minutes après la première tentative.