

• 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:branch`: esecuzione delle fasi di automazione condizionale
<a name="automation-action-branch"></a>

L'operazione `aws:branch` consente di creare un'automazione dinamica che valuta le diverse scelte in una singola fase e quindi passa a una fase diversa nel runbook in base ai risultati di tale valutazione. 

Quando per una fase viene specificata l'operazione `aws:branch`, è necessario specificare l'elemento `Choices` l'automazione deve valutare. L'elemento `Choices` può fare riferimento a un valore specificato nella sezione `Parameters` del runbook oppure a un valore dinamico generato come output di una fase precedente. L'automazione valuta ogni scelta utilizzando un'espressione booleana. Se la prima scelta è "true", l'automazione passa alla fase definita per tale scelta. Se la prima scelta è "false", l'automazione valuta la scelta successiva. L'automazione continua la valutazione di ogni scelta finché non elabora una scelta "true". L'automazione passa quindi alla fase definita per la scelta di tipo "true".

Se nessuna delle scelte restituisce "true", l'automazione controlla se la fase contiene un valore di `default`. Un valore di default definisce una fase in cui l'automazione deve passare se nessuna delle scelte restituisce "true". Se non è stato specificato alcun valore di `default` per la fase, l'automazione elabora la fase successiva nel runbook.

L'operazione `aws:branch` supporta valutazioni di scelte complesse mediante l'uso di una combinazione di operatori `And`, `Not` e `Or`. Per ulteriori informazioni su come utilizzare `aws:branch`, con runbook di esempio ed esempi che utilizzano diversi operatori, consulta [Utilizzo di istruzioni condizionali nei runbook](automation-branch-condition.md).

**Input**  
Specificare uno o più elementi `Choices` in una fase. L'elemento `Choices` può fare riferimento a un valore specificato nella sezione `Parameters` del runbook oppure a un valore dinamico generato come output di una fase precedente. Ecco un esempio di sintassi YAML che restituisce un parametro.

```
mainSteps:
- name: chooseOS
  action: aws:branch
  inputs:
    Choices:
    - NextStep: runWindowsCommand
      Variable: "{{{{Name of a parameter defined in the Parameters section. For example: OS_name}}}}"
      StringEquals: windows
    - NextStep: runLinuxCommand
      Variable: "{{{{Name of a parameter defined in the Parameters section. For example: OS_name}}}}"
      StringEquals: linux
    Default:
      sleep3
```

Ecco un esempio di sintassi YAML che valuta l'output di una fase precedente.

```
mainSteps:
- name: chooseOS
  action: aws:branch
  inputs:
    Choices:
    - NextStep: runPowerShellCommand
      Variable: "{{{{Name of a response object. For example: GetInstance.platform}}}}"
      StringEquals: Windows
    - NextStep: runShellCommand
      Variable: "{{{{Name of a response object. For example: GetInstance.platform}}}}"
      StringEquals: Linux
    Default:
      sleep3
```

Choices  
Una o più espressioni che il servizio di automazione deve valutare durante l'individuazione della fase successiva da elaborare. Le scelte vengono valutate utilizzando un'espressione booleana. Ogni scelta deve definire le seguenti opzioni:  
+ **NextStep**: Il passaggio successivo del runbook da elaborare se la scelta designata è vera.
+ **Variable**: specifica il nome di un parametro definito nella sezione `Parameters` del runbook. In alternativa, specifica un oggetto di output della fase precedente nel runbook. Per ulteriori informazioni sulla creazione di variabili per `aws:branch`, consulta [Informazioni sulla creazione della variabile di output](automation-branch-condition.md#branch-action-output).
+ **Operation**: i criteri utilizzati per valutare la scelta. L'operazione `aws:branch` supporta le operazioni seguenti:

**Operazioni di stringa**
  + StringEquals
  + EqualsIgnoreCase
  + StartsWith
  + EndsWith
  + Contiene

**Operazioni numeriche**
  + NumericEquals
  + NumericGreater
  + NumericLesser
  + NumericGreaterOrEquals
  + NumericLesser
  + NumericLesserOrEquals

**Operazioni booleane**
  + BooleanEquals
**Importante**  
Quando si crea un runbook, il sistema convalida ogni operazione nel runbook. Se un'operazione non è supportata, il sistema restituisce un errore quando si tenta di creare il runbook.

Predefinito  
Nome di una fase a cui l'automazione deve passare se nessuno degli elementi `Choices` restituisce "true".  
▬Tipo: stringa  
Obbligatorio: no

**Nota**  
L'operazione `aws:branch` supporta gli operatori `And`, `Or` e `Not`. Per esempi di operazioni `aws:branch` che utilizzano gli operatori, consulta [Utilizzo di istruzioni condizionali nei runbook](automation-branch-condition.md).