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.
Vous pouvez afficher toutes les exécutions pour un ID d'association spécifique à l'aide de l'opération DescribeAssociationExecutionsAPI. Utilisez cette opération pour voir le statut, le statut détaillé, les résultats, l'heure de la dernière exécution et plus d'informations sur un State Manager association. State Manager est un outil dans AWS Systems Manager. Cette opération d'API inclut également des filtres pour vous aider à trouver les associations correspondant aux critères que vous spécifiez. Par exemple, vous pouvez spécifier une date et une heure précises, et utiliser un filtre GREATER_THAN pour afficher les exécutions qui ont été traitées après la date et l'heure spécifiées.
Si, par exemple, l'exécution d'une association a échoué, vous pouvez approfondir les détails d'une exécution spécifique à l'aide de l'opération DescribeAssociationExecutionTargetsd'API. Cette opération vous montre les ressources, telles que le nœud IDs, sur lesquelles l'association s'est exécutée et les différents statuts de l'association. Vous pouvez ensuite constater quel nœud ou quelle ressource n'est pas parvenu à exécuter une association. Vous pouvez utiliser l'ID de ressource pour afficher les détails de l'exécution d'une commande et identifier ainsi l'étape de la commande qui a échoué.
Les exemples de cette section incluent également des informations sur la façon d'utiliser l'opération StartAssociationsOnceAPI pour exécuter une association une fois au moment de sa création. Vous pouvez utiliser cette opération d'API lorsque vous examinez les exécutions d'associations qui ont échoué. Si vous constatez qu'une association a échoué, vous pouvez effectuer une modification sur la ressource, puis exécuter immédiatement cette association pour déterminer si la modification effectuée sur la ressource permet à l'association de s'exécuter correctement.
Note
Les opérations d'API initiées par le document SSM lors d'une exécution d'association ne sont pas journalisées dans AWS CloudTrail.
Affichage des historiques des associations (console)
Utilisez la procédure suivante pour afficher l'historique d'association correspondant à un ID d'association spécifique et afficher ensuite les détails de l'exécution pour une ou plusieurs ressources.
Pour afficher l'historique d'exécution correspondant à un ID d'association spécifique
Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/
. -
Choisissez State Manager.
-
Dans le champ ID d'association, sélectionnez l'association dont vous souhaitez afficher l'historique.
-
Sélectionnez le bouton Afficher les détails.
-
Sélectionnez l'onglet Historique d'exécution.
-
Sélectionnez une association dont vous souhaitez afficher les détails d'exécution au niveau des ressources. Par exemple, sélectionnez une association qui indique le statut Échec. Vous pouvez ensuite consulter les détails d'exécution pour les nœuds qui n'ont pas réussi à exécuter l'association.
Utilisez les filtres de la zone de recherche pour rechercher l'exécution dont vous souhaitez afficher les détails.
-
Sélectionnez un ID d'exécution. La page Association execution targets (Cibles d'exécution de l'association) s'ouvre. Cette page affiche toutes les ressources qui ont exécuté l'association.
-
Sélectionnez un ID de ressource pour afficher les informations spécifiques relatives à cette ressource.
Utilisez les filtres de la zone de recherche pour rechercher la ressource dont vous souhaitez afficher les détails.
-
Si vous effectuez une recherche sur une association dont l'exécution a échoué, vous pouvez utiliser le bouton Appliquer l'association maintenant pour exécuter une association une seule fois lors de sa création. Une fois que vous avez modifié la ressource sur laquelle l'exécution de l'association a échoué, sélectionnez le lien ID d'association dans le chemin de navigation.
-
Sélectionnez le bouton Appliquer l'association maintenant. Une fois l'exécution terminée, vérifiez que l'exécution de l'association a réussi.
Affichage des historiques d'associations (ligne de commande)
La procédure suivante décrit comment utiliser le AWS Command Line Interface (AWS CLI) (sous Linux ou Windows) ou comment Outils AWS pour PowerShell afficher l'historique d'exécution d'un ID d'association spécifique. Ensuite, la procédure décrit comment afficher les détails d'exécution d'une ou de plusieurs ressources.
Pour afficher l'historique d'exécution correspondant à un ID d'association spécifique
Installez et configurez le AWS CLI ou le Outils AWS pour PowerShell, si ce n'est pas déjà fait.
Pour plus d'informations, consultez la section Installation ou mise à jour de la version la plus récente de l' AWS CLI et Installation d' Outils AWS pour PowerShell.
-
Exécutez la commande suivante pour afficher la liste des exécutions correspondant à un ID d'association spécifique.
aws ssm describe-association-executions \ --association-idID\ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THANNote
Cette commande inclut un filtre pour limiter les résultats aux exécutions qui se sont produites après une date et une heure spécifiques. Pour afficher toutes les exécutions correspondant à un ID d'association spécifique, supprimez le paramètre
--filterset la valeurKey=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN.Le système retourne des informations telles que les suivantes.
{ "AssociationExecutions":[ { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE", "ExecutionId":"76a5a04f-caf6-490c-b448-92c02EXAMPLE", "CreatedTime":1523986028.219, "AssociationVersion":"1" }, { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE", "ExecutionId":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE", "CreatedTime":1523984226.074, "AssociationVersion":"1" }, { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE", "ExecutionId":"ecec60fa-6bb0-4d26-98c7-140308EXAMPLE", "CreatedTime":1523982404.013, "AssociationVersion":"1" } ] }
Vous pouvez limiter les résultats en utilisant un ou plusieurs filtres. L'exemple suivant renvoie toutes les associations qui ont été exécutées avant une date et une heure spécifiques.
aws ssm describe-association-executions \ --association-idID\ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THANL'exemple suivant renvoie toutes les associations qui ont été exécutées correctement après une date et une heure spécifiques.
aws ssm describe-association-executions \ --association-idID\ --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN Key=Status,Value=Success,Type=EQUAL -
Exécutez la commande suivante pour afficher toutes les cibles sur lesquelles l'exécution spécifique a eu lieu.
aws ssm describe-association-execution-targets \ --association-idID\ --execution-idIDVous pouvez limiter les résultats en utilisant un ou plusieurs filtres. L'exemple suivant renvoie les informations relatives à toutes les cibles sur lesquelles l'exécution de l'association spécifique a échoué.
aws ssm describe-association-execution-targets \ --association-idID\ --execution-idID\ --filters Key=Status,Value="Failed"L'exemple suivant renvoie les informations relatives à un nœud géré spécifique sur lequel l'exécution d'une association a échoué.
aws ssm describe-association-execution-targets \ --association-idID\ --execution-idID\ --filters Key=Status,Value=Failed Key=ResourceId,Value="i-02573cafcfEXAMPLE" Key=ResourceType,Value=ManagedInstance -
Si vous étudiez une association qui n'a pas pu s'exécuter, vous pouvez utiliser l'opération d'StartAssociationsOnceAPI pour exécuter une association immédiatement et une seule fois. Lorsque vous modifiez la ressource sur laquelle l'exécution de l'association a échoué, utilisez la commande suivante pour exécuter l'association immédiatement et une seule fois.
aws ssm start-associations-once \ --association-idID
