aws:branch: esecuzione delle fasi di automazione condizionale - AWS Systems Manager

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

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.

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: la fase successiva nel runbook da elaborare se la scelta designata è "true".

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

  • Operation: i criteri utilizzati per valutare la scelta. L'operazione aws:branch supporta le operazioni seguenti:

    Operazioni di stringa
    • StringEquals

    • EqualsIgnoreCase

    • StartsWith

    • EndsWith

    • Contains

    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.

Default (predefinito)

Nome di una fase a cui l'automazione deve passare se nessuno degli elementi Choices restituisce "true".

Tipo: string

Campo 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.