• 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 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. # Exécutez des automatisations en fonction des événements EventBridge Vous pouvez démarrer une automatisation en spécifiant un runbook comme cible d'un EventBridge événement Amazon. Vous pouvez démarrer des automatisations selon un programme ou lorsqu'un événement de système AWS spécifique se produit. Supposons, par exemple, que vous créiez un runbook nommé *BootStrapInstances*qui installe le logiciel sur une instance au démarrage de celle-ci. Pour spécifier le *BootStrapInstances*runbook (et l'automatisation correspondante) comme cible d'un EventBridge événement, vous devez d'abord créer une nouvelle EventBridge règle. (Voici un exemple de règle : **Nom de service**: EC2, **Type d'événement**: Notification de modification d'état d'instance EC2, **État(s) spécifique(s)**: en cours exécution, **Toute instance**.) Vous devez ensuite utiliser les procédures suivantes pour spécifier le *BootStrapInstances*runbook comme cible de l'événement à l'aide de la EventBridge console et AWS Command Line Interface (AWS CLI). Lors du démarrage d'une nouvelle instance, le système exécute l'automatisation et installe le logiciel. Pour plus d'informations sur la création de runbooks, consultez [Créer vos propres runbooks](automation-documents.md). ## Création d'un EventBridge événement utilisant un runbook (console) Utilisez la procédure suivante pour configurer un runbook comme cible d'un EventBridge événement. **Pour configurer un runbook en tant que cible d'une règle d' EventBridge événement** 1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Dans le panneau de navigation, choisissez **Rules**. 1. Choisissez **Créer une règle**. 1. Saisissez un nom et une description pour la règle. Une règle ne peut pas avoir le même nom qu'une autre règle de la même région et sur le même bus d'événement. 1. Pour **Event bus** (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle réponde aux événements correspondants qui proviennent des vôtres Compte AWS, sélectionnez **par défaut**. Lorsqu'un événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte. 1. Choisissez comment la règle est déclenchée. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/running-automations-event-bridge.html) 1. Choisissez **Suivant**. 1. Pour **Types de cibles**, choisissez **service AWS **. 1. Pour **Select a target** (Sélectionner une cible), choisissez **Systems Manager Automation**. 1. Pour **Document**, sélectionnez un runbook à utiliser lorsque votre cible est appelée. 1. Dans la section **Configure automation parameter(s)** (Configurer le(s) paramètre(s) d'automatisation), conservez les valeurs de paramètre par défaut (si disponibles) ou saisissez vos propres valeurs. **Note** Pour créer une cible, vous devez spécifier une valeur pour chaque paramètre requis. Si vous ne le faites pas, le système crée la règle mais elle ne s'exécute pas. 1. Pour de nombreux types de cibles, EventBridge nécessite des autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle IAM nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes : + Pour créer un rôle IAM automatiquement, sélectionnez **Create a new role for this specific resource**. + Pour utiliser un rôle IAM que vous avez créé précédemment, choisissez **Use existing role** (Utiliser un rôle existant) et sélectionnez le rôle existant dans la liste déroulante. Notez que vous devrez peut-être mettre à jour la politique de confiance pour inclure EventBridge votre rôle IAM. Voici un exemple : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": [ "events.amazonaws.com", "ssm.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Choisissez **Suivant**. 1. (Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour plus d'informations, consultez la section [Marquage de vos EventBridge ressources Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-tagging.html) dans le *guide de l' EventBridge utilisateur Amazon*. 1. Choisissez **Suivant**. 1. Consultez les détails de la règle et choisissez **Create rule** (Créer une règle). ## Création d'un EventBridge événement utilisant un runbook (ligne de commande) La procédure suivante décrit comment utiliser AWS CLI (sous Linux ou Windows) ou comment Outils AWS pour PowerShell créer une règle d' EventBridge événement et configurer un runbook comme cible. **Pour configurer un runbook en tant que cible d'une règle d' EventBridge événement** 1. 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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) et [Installation d' Outils AWS pour PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html). 1. Créez une commande pour spécifier une nouvelle règle EventBridge d'événement. Remplacez chaque *example resource placeholder* par vos propres informations. *Déclencheurs basés sur un calendrier* ------ #### [ Linux & macOS ] ``` aws events put-rule \ --name "rule name" \ --schedule-expression "cron or rate expression" ``` ------ #### [ Windows ] ``` aws events put-rule ^ --name "rule name" ^ --schedule-expression "cron or rate expression" ``` ------ #### [ PowerShell ] ``` Write-CWERule ` -Name "rule name" ` -ScheduleExpression "cron or rate expression" ``` ------ L'exemple suivant crée une règle d' EventBridge événement qui commence tous les jours à 9 h 00 (UTC). ------ #### [ Linux & macOS ] ``` aws events put-rule \ --name "DailyAutomationRule" \ --schedule-expression "cron(0 9 * * ? *)" ``` ------ #### [ Windows ] ``` aws events put-rule ^ --name "DailyAutomationRule" ^ --schedule-expression "cron(0 9 * * ? *)" ``` ------ #### [ PowerShell ] ``` Write-CWERule ` -Name "DailyAutomationRule" ` -ScheduleExpression "cron(0 9 * * ? *)" ``` ------ *Déclencheurs basés sur un événement* ------ #### [ Linux & macOS ] ``` aws events put-rule \ --name "rule name" \ --event-pattern "{\"source\":[\"aws.service\"],\"detail-type\":[\"service event detail type\"]}" ``` ------ #### [ Windows ] ``` aws events put-rule ^ --name "rule name" ^ --event-pattern "{\"source\":[\"aws.service\"],\"detail-type\":[\"service event detail type\"]}" ``` ------ #### [ PowerShell ] ``` Write-CWERule ` -Name "rule name" ` -EventPattern '{"source":["aws.service"],"detail-type":["service event detail type"]}' ``` ------ L'exemple suivant crée une règle d' EventBridge événement qui démarre lorsqu'une instance EC2 de la région change d'état. ------ #### [ Linux & macOS ] ``` aws events put-rule \ --name "EC2InstanceStateChanges" \ --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"]}" ``` ------ #### [ Windows ] ``` aws events put-rule ^ --name "EC2InstanceStateChanges" ^ --event-pattern "{\"source\":[\"aws.ec2\"],\"detail-type\":[\"EC2 Instance State-change Notification\"]}" ``` ------ #### [ PowerShell ] ``` Write-CWERule ` -Name "EC2InstanceStateChanges" ` -EventPattern '{"source":["aws.ec2"],"detail-type":["EC2 Instance State-change Notification"]}' ``` ------ La commande renvoie les détails de la nouvelle EventBridge règle de la même manière que ci-dessous. ------ #### [ Linux & macOS ] ``` { "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/automationrule" } ``` ------ #### [ Windows ] ``` { "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/automationrule" } ``` ------ #### [ PowerShell ] ``` arn:aws:events:us-east-1:123456789012:rule/EC2InstanceStateChanges ``` ------ 1. Créez une commande pour spécifier un runbook comme cible de la règle d' EventBridge événement que vous avez créée à l'étape 2. Remplacez chaque *example resource placeholder* par vos propres informations. ------ #### [ Linux & macOS ] ``` aws events put-targets \ --rule rule name \ --targets '{"Arn": " arn:aws:ssm:region:account ID:automation-definition/runbook name","Input":"{\"Message\":[\"{\\\"Key\\\":\\\"key name\\\",\\\"Values\\\":[\\\"value\\\"]}\"]}","Id": "target ID","RoleArn": "arn:aws:iam::123456789012:role/service-role/EventBridge service role"}' ``` ------ #### [ Windows ] ``` aws events put-targets ^ --rule rule name ^ --targets '{"Arn": "arn:aws:ssm:region:account ID:automation-definition/runbook name","Input":"{\"Message\":[\"{\\\"Key\\\":\\\"key name\\\",\\\"Values\\\":[\\\"value\\\"]}\"]}","Id": "target ID","RoleArn": "arn:aws:iam::123456789012:role/service-role/EventBridge service role"}' ``` ------ #### [ PowerShell ] ``` $Target = New-Object Amazon.CloudWatchEvents.Model.Target $Target.Id = "target ID" $Target.Arn = "arn:aws:ssm:region:account ID:automation-definition/runbook name" $Target.RoleArn = "arn:aws:iam::123456789012:role/service-role/EventBridge service role" $Target.Input = '{"input parameter":["value"],"AutomationAssumeRole":["arn:aws:iam::123456789012:role/AutomationServiceRole"]}' Write-CWETarget ` -Rule "rule name" ` -Target $Target ``` ------ L'exemple suivant crée une cible d' EventBridge événement qui démarre l'ID d'instance spécifié à l'aide du runbook`AWS-StartEC2Instance`. ------ #### [ Linux & macOS ] ``` aws events put-targets \ --rule DailyAutomationRule \ --targets '{"Arn": "arn:aws:ssm:region:*:automation-definition/AWS-StartEC2Instance","Input":"{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"],\"AutomationAssumeRole\":[\"arn:aws:iam::123456789012:role/AutomationServiceRole\"]}","Id": "Target1","RoleArn": "arn:aws:iam::123456789012:role/service-role/AWS_Events_Invoke_Start_Automation_Execution_1213609520"}' ``` ------ #### [ Windows ] ``` aws events put-targets ^ --rule DailyAutomationRule ^ --targets '{"Arn": "arn:aws:ssm:region:*:automation-definition/AWS-StartEC2Instance","Input":"{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"],\"AutomationAssumeRole\":[\"arn:aws:iam::123456789012:role/AutomationServiceRole\"]}","Id": "Target1","RoleArn": "arn:aws:iam::123456789012:role/service-role/AWS_Events_Invoke_Start_Automation_Execution_1213609520"}' ``` ------ #### [ PowerShell ] ``` $Target = New-Object Amazon.CloudWatchEvents.Model.Target $Target.Id = "Target1" $Target.Arn = "arn:aws:ssm:region:*:automation-definition/AWS-StartEC2Instance" $Target.RoleArn = "arn:aws:iam::123456789012:role/service-role/AWS_Events_Invoke_Start_Automation_Execution_1213609520" $Target.Input = '{"InstanceId":["i-02573cafcfEXAMPLE"],"AutomationAssumeRole":["arn:aws:iam::123456789012:role/AutomationServiceRole"]}' Write-CWETarget ` -Rule "DailyAutomationRule" ` -Target $Target ``` ------ Le système retourne des informations telles que les suivantes. ------ #### [ Linux & macOS ] ``` { "FailedEntries": [], "FailedEntryCount": 0 } ``` ------ #### [ Windows ] ``` { "FailedEntries": [], "FailedEntryCount": 0 } ``` ------ #### [ PowerShell ] Il n'y a aucune sortie si la commande aboutit pour PowerShell. ------