

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esegui automazioni basate su eventi EventBridge
<a name="running-automations-event-bridge"></a>

Puoi avviare un'automazione specificando un runbook come destinazione di un evento Amazon EventBridge. È possibile avviare le automazioni in base a una pianificazione oppure quando si verifica un determinato evento di sistema di AWS . Ad esempio, supponiamo che tu crei un runbook denominato *BootStrapInstances*che installa il software su un'istanza all'avvio di un'istanza. Per specificare il *BootStrapInstances*runbook (e l'automazione corrispondente) come destinazione di un EventBridge evento, devi prima creare una nuova regola. EventBridge (Ecco una regola di esempio: **Nome del servizio**: EC2, **Tipo di evento**: State-change Notifica dell'istanza EC2, **Stati specifici: in esecuzione, **Qualsiasi** istanza.)** Quindi si utilizzano le seguenti procedure per specificare il *BootStrapInstances*runbook come destinazione dell'evento utilizzando la EventBridge console e AWS Command Line Interface ().AWS CLI All'avvio di una nuova istanza, il sistema eseguirà l'automazione e installerà il software.

Per ulteriori informazioni sulla creazione di runbook, consulta [Creazione di runbook personalizzati](automation-documents.md).

## Creazione di un EventBridge evento che utilizza un runbook (console)
<a name="automation-cwe-target-console"></a>

Utilizzate la procedura seguente per configurare un runbook come destinazione di un EventBridge evento.

**Per configurare un runbook come destinazione di una regola di evento EventBridge**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel pannello di navigazione, scegli **Regole**.

1. Scegli **Crea regola**.

1. Inserisci un nome e una descrizione per la regola.

   Una regola non può avere lo stesso nome di un'altra regola nella stessa Regione e sullo stesso router di eventi.

1. Per **Router di eventi**, seleziona il router di eventi che desideri associare a questa regola. Se desideri che questa regola risponda agli eventi corrispondenti generati dai tuoi Account AWS, seleziona **Predefinito**. Quando un Servizio AWS utente del tuo account emette un evento, questo passa sempre al bus eventi predefinito del tuo account.

1. Scegli come attivare la regola.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/running-automations-event-bridge.html)

1. Scegli **Next (Successivo)**.

1. Per **Tipi di destinazione**, scegli **servizio AWS **.

1. Per **Seleziona destinazione**, scegli **Automazione di Systems Manager**. 

1. Per **Documento**, scegli un runbook da usare quando viene chiamata la destinazione.

1. Nella sezione **Configura parametri automazione** non modificare i valori predefiniti dei parametri (se disponibili) oppure inserisci i valori desiderati. 
**Nota**  
Per creare una destinazione, è necessario specificare un valore per ciascun parametro obbligatorio. In caso contrario, la regola verrà creata dal sistema ma non verrà eseguita.

1. Per molti tipi di target, EventBridge sono necessarie le autorizzazioni per inviare eventi alla destinazione. In questi casi, EventBridge può creare il ruolo IAM necessario per l'esecuzione della regola. Esegui una delle seguenti operazioni:
   + Per creare un ruolo IAM automaticamente, seleziona **Crea un nuovo ruolo per questa risorsa specifica**.
   + Per utilizzare un ruolo IAM creato in precedenza, seleziona **Utilizza un ruolo esistente** e seleziona il ruolo esistente dal menu a discesa. Tieni presente che potresti dover aggiornare la policy di fiducia da includere nel tuo ruolo IAM EventBridge. Di seguito è riportato un esempio:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "{{events.amazonaws.com}}",
                       "ssm.amazonaws.com"
                   ]
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }
   ```

------

1. Scegli **Next (Successivo)**.

1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta [Tagging Your Amazon EventBridge Resources](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-tagging.html) nella *Amazon EventBridge User Guide*.

1. Scegli **Next (Successivo)**.

1. Rivedi i dettagli della regola e scegli **Crea regola**.

## Crea un EventBridge evento che utilizza un runbook (riga di comando)
<a name="automation-cwe-target-commandline"></a>

La procedura seguente descrive come utilizzare AWS CLI (su Linux o Windows) o AWS Strumenti per PowerShell creare una regola di EventBridge evento e configurare un runbook come destinazione.

**Per configurare un runbook come destinazione di una regola di evento EventBridge**

1. Installa e configura il AWS CLI o il AWS Strumenti per PowerShell, se non l'hai già fatto.

   Per informazioni, consulta le pagine [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Installazione di AWS Strumenti per PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html).

1. Crea un comando per specificare una nuova regola di EventBridge evento. Sostituisci ogni {{example resource placeholder}} con le tue informazioni.

   *Attivazioni basate su una pianificazione*

------
#### [ 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'esempio seguente crea una regola di EventBridge evento che inizia ogni giorno alle 9: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 * * ? *)"
   ```

------

   *Attivazioni basate su un evento*

------
#### [ 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'esempio seguente crea una regola di EventBridge evento che si avvia quando un'istanza EC2 nella regione cambia stato.

------
#### [ 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"]}'
   ```

------

   Il comando restituisce dettagli per la nuova EventBridge regola simili ai seguenti.

------
#### [ 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. Create un comando per specificare un runbook come destinazione della regola EventBridge evento creata nel passaggio 2. Sostituisci ogni {{example resource placeholder}} con le tue informazioni.

------
#### [ 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'esempio seguente crea un target di EventBridge evento che avvia l'ID di istanza specificato utilizzando il `AWS-StartEC2Instance` runbook.

------
#### [ 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
   ```

------

   Il sistema restituisce informazioni simili alle seguenti.

------
#### [ Linux & macOS ]

   ```
   {
   "FailedEntries": [],
   "FailedEntryCount": 0
   }
   ```

------
#### [ Windows ]

   ```
   {
   "FailedEntries": [],
   "FailedEntryCount": 0
   }
   ```

------
#### [ PowerShell ]

   Non viene prodotto alcun output se il comando ha esito positivo per. PowerShell

------