

• 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à.

# `aws:executeAutomation`: esecuzione di un'altra automazione
<a name="automation-action-executeAutomation"></a>

Esegue un'automazione secondaria mediante una chiamata a un runbook secondario. Questa operazione consente di creare runbook per le operazioni più comuni e fare riferimento a tali runbook durante l'automazione. Questa operazione permette di semplificare i runbook in quanto elimina la necessità di duplicare le fasi tra runbook simili.

L'automazione secondaria viene eseguita nel contesto dell'utente che ha avviato l'automazione principale. Ciò significa che l'automazione secondaria utilizza lo stesso ruolo o utente AWS Identity and Access Management (IAM) dell'utente che ha avviato la prima automazione.

**Importante**  
Se è necessario specificare i parametri in un'automazione secondaria che utilizza un ruolo presunto (un ruolo che usa la policy iam:passRole), l'utente o il ruolo che ha avviato l'automazione principale deve disporre dell'autorizzazione necessaria per passare il ruolo presunto specificato nell'automazione secondaria. Per ulteriori informazioni sulla configurazione di un ruolo presunto per l'automazione, consulta [Crea ruoli di servizio per l'automazione tramite la console](automation-setup-iam.md).

**Input**

------
#### [ YAML ]

```
name: Secondary_Automation
action: aws:executeAutomation
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  DocumentName: secondaryAutomation
  RuntimeParameters:
    instanceIds:
    - i-1234567890abcdef0
```

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

```
{
   "name":"Secondary_Automation",
   "action":"aws:executeAutomation",
   "maxAttempts":3,
   "timeoutSeconds":3600,
   "onFailure":"Abort",
   "inputs":{
      "DocumentName":"secondaryAutomation",
      "RuntimeParameters":{
         "instanceIds":[
            "i-1234567890abcdef0"
         ]
      }
   }
}
```

------

DocumentName  
Nome del runbook secondario da eseguire durante la fase. Per i runbook dello stesso Account AWS, specifica il nome del runbook. Per i runbook condivisi da un altro Account AWS, specifica l'Amazon Resource Name (ARN) del runbook. Per informazioni sull'uso di runbook condivisi, consulta [Utilizzo di documenti SSM condivisi](documents-ssm-sharing.md#using-shared-documents).  
Tipo: stringa  
Obbligatorio: sì

DocumentVersion  
Versione del runbook secondario da eseguire. Se non è specificato, il servizio di automazione esegue la versione predefinita del runbook.  
▬Tipo: stringa  
Obbligatorio: no

MaxConcurrency  
Il numero massimo di destinazioni consentito per eseguire questa operazione in parallelo. È possibile specificare un numero, ad esempio 10, o una percentuale, ad esempio 10%.  
▬Tipo: stringa  
Obbligatorio: no

MaxErrors  
Numero di errori consentiti prima che il sistema interrompa l'esecuzione dell'automazione su destinazioni aggiuntive. Puoi specificare un numero assoluto di errori, ad esempio 10, oppure una percentuale della serie di destinazioni, ad esempio 10%. Se ad esempio specifichi 3, il sistema interrompe l'esecuzione dell'automazione quando riceve il quarto errore. Se specifichi 0, il sistema interrompe l'esecuzione dell'automazione su destinazioni aggiuntive dopo che viene restituito il risultato del primo errore. Se si esegue un'automazione su 50 risorse e si imposta `MaxErrors` sul 10%, il sistema interrompe l'esecuzione dell'automazione su destinazioni aggiuntive quando riceve il sesto errore.  
Alle automazioni già in esecuzione al raggiungimento della soglia di `MaxErrors`, è permesso di arrivare al termine; tuttavia, queste automazioni potrebbero anche avere esito negativo. Se è necessario assicurarsi che non ci saranno più automazioni non riuscite rispetto alla soglia di `MaxErrors`, impostare `MaxConcurrency` su 1 in modo che le automazioni procedano una alla volta.  
▬Tipo: stringa  
Obbligatorio: no

RuntimeParameters  
Parametri obbligatori per il runbook secondario. La mappatura usa il seguente formato: \$1"parameter1" : "value1", "parameter2" : "value2" \$1  
Tipo: Map  
Obbligatorio: no

Tag  
I metadati facoltativi assegnati a una risorsa. È possibile specificare un massimo di cinque tag per un'automazione.  
Tipo: MapList  
Obbligatorio: no

TargetLocations  
Una posizione è una combinazione di Regioni AWS e/o Account AWS dove si desidera eseguire l'automazione. È necessario specificare un numero minimo di 1 elemento ed è possibile specificare un numero massimo di 100 elementi. Quando si specifica un valore per questo parametro, gli output non vengono restituiti all'automazione padre. Se necessario, bisogna effettuare chiamate successive alle operazioni API per recuperare l'output dalle automazioni figlio.  
Tipo: MapList  
Obbligatorio: no

TargetMaps  
Un elenco di mappature chiave-valore dei parametri del documento alle risorse di destinazione. Sia `Targets` che `TargetMaps` non possono essere specificati insieme.   
Tipo: MapList  
Obbligatorio: no

TargetParameterName  
Nome del parametro utilizzato come risorsa di destinazione per l'automazione controllata dalla velocità. Necessario solo se si specificano `Targets`.  
▬Tipo: stringa  
Obbligatorio: no

Target  
Un elenco di mapping chiave-valore alle risorse di destinazione. Necessario solo se si specifica `TargetParameterName`.  
Tipo: MapList  
Obbligatorio: noOutput

Output  
Output generato dall'automazione secondaria. È possibile fare riferimento all'output utilizzando il seguente formato: *Secondary\$1Automation\$1Step\$1Name* .Output  
Tipo: StringList  
Ecco un esempio:  

```
- name: launchNewWindowsInstance
  action: 'aws:executeAutomation'
  onFailure: Abort
  inputs:
    DocumentName: launchWindowsInstance
  nextStep: getNewInstanceRootVolume
- name: getNewInstanceRootVolume
  action: 'aws:executeAwsApi'
  onFailure: Abort
  inputs:
    Service: ec2
    Api: DescribeVolumes
    Filters:
    - Name: attachment.device
      Values:
      - /dev/sda1
    - Name: attachment.instance-id
      Values:
      - '{{launchNewWindowsInstance.Output}}'
  outputs:
  - Name: rootVolumeId
    Selector: '$.Volumes[0].VolumeId'
    Type: String
  nextStep: snapshotRootVolume
- name: snapshotRootVolume
  action: 'aws:executeAutomation'
  onFailure: Abort
  inputs:
    DocumentName: AWS-CreateSnapshot
    RuntimeParameters:
    VolumeId:
    - '{{getNewInstanceRootVolume.rootVolumeId}}'
    Description:
    - 'Initial root snapshot for {{launchNewWindowsInstance.Output}}'
```

ExecutionId  
ID dell'automazione secondaria.  
Tipo: String

Status  
Stato dell'automazione secondaria.  
Tipo: String