Enregistrement de tâches de fenêtre de maintenance sans cibles - AWS Systems Manager

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.

Enregistrement de tâches de fenêtre de maintenance sans cibles

Pour chaque fenêtre de maintenance créée, vous pouvez spécifier une ou plusieurs tâches à effectuer lors de l'exécution de la fenêtre de maintenance. Dans la plupart des cas, vous devez spécifier les ressources, ou cibles, sur lesquelles la tâche doit s'exécuter. Dans certains cas, cependant, vous n'avez pas à spécifier explicitement des cibles dans la tâche.

Une ou plusieurs cibles doivent être spécifiées pour la fenêtre de maintenance | Systems Manager Run Command-tapez des tâches. Selon la nature de la tâche, les cibles sont facultatives pour les autres types de tâches de la fenêtre de maintenance (Systems Manager Automation AWS Lambda, et AWS Step Functions).

Pour les types de tâches Lambda et Step Functions, la nécessité d'une cible dépend du contenu de la fonction ou de la machine d'état que vous avez créée.

Dans bien des cas, vous n'avez pas à spécifier explicitement une cible pour une tâche d'automatisation. Supposons, par exemple, que vous créez une tâche de type automatisation pour mettre à jour un Amazon Machine Image (AMI) pour Linux en utilisant le AWS-UpdateLinuxAmi runbook. Lorsque la tâche est exécutée, AMI est mis à jour avec les derniers packages de distribution Linux disponibles et les derniers logiciels Amazon. Nouvelles instances créées à partir du AMI ces mises à jour sont déjà installées. Parce que l'identifiant du AMI à mettre à jour est spécifié dans les paramètres d'entrée du runbook, il n'est pas nécessaire de spécifier à nouveau une cible dans la tâche de la fenêtre de maintenance.

De même, supposons que vous utilisiez le AWS Command Line Interface (AWS CLI) pour enregistrer une tâche d'automatisation de la fenêtre de maintenance qui utilise le AWS-RestartEC2Instance runbook. Comme le nœud à redémarrer est spécifié dans l'argument --task-invocation-parameters, l'option --targets n'est pas nécessaire.

Note

Pour les tâches de la fenêtre de maintenance qui n'ont pas de cible spécifiée, vous ne pouvez pas fournir de valeurs pour --max-errors et --max-concurrency. Au lieu de cela, le système insère une valeur fictive de1, qui peut être signalée en réponse à des commandes telles que describe-maintenance-window-tasks et get-maintenance-window-task. Ces valeurs n'affectent pas l'exécution de votre tâche et peuvent être ignorées.

Les exemples suivants montrent également que les options --targets, --max-errors et --max-concurrency peuvent être omises pour une tâche de fenêtre de maintenance sans cible.

Linux & macOS
aws ssm register-task-with-maintenance-window \ --window-id "mw-ab12cd34eEXAMPLE" \ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" \ --task-type "AUTOMATION" \ --name "RestartInstanceWithoutTarget" \ --task-arn "AWS-RestartEC2Instance" \ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" \ --priority 10
Windows
aws ssm register-task-with-maintenance-window ^ --window-id "mw-ab12cd34eEXAMPLE" ^ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" ^ --task-type "AUTOMATION" ^ --name "RestartInstanceWithoutTarget" ^ --task-arn "AWS-RestartEC2Instance" ^ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" ^ --priority 10
Note

Pour les tâches du créneau de maintenance enregistrées avant le 23 décembre 2020 : si vous avez spécifié des cibles pour la tâche et que l'une d'elles n'est plus nécessaire, vous pouvez mettre à jour cette tâche pour supprimer les cibles à l'aide de la console Systems Manager ou du update-maintenance-window-task AWS CLI commande.