aws:branch - Ausführen bedingter Automatisierungsschritte

Die Aktion aws:branch erlaubt das Erstellen einer dynamischen Automatisierung, der verschiedene Auswahlmöglichkeiten in einem einzigen Schritt evaluiert und dann auf der Grundlage dieser Evaluierung zu einem anderen Schritt in dem Runbook springt.

Wenn Sie die Aktion aws:branch für einen Schritt angeben, geben Sie die Choices an, die die Automatisierung evaluieren muss. Die Choices können auf einem Wert basieren, den Sie im Abschnitt Parameters des Runbooks angegeben haben, oder auf einem als Ausgabe von dem vorherigen Schritt generierten dynamischen Wert basieren. Die Automatisierung evaluiert jede Auswahl mithilfe eines booleschen Ausdrucks. Wenn die erste Auswahl „wahr“ ist, springt die Automatisierung zu dem für diese Auswahl vorgesehenen Schritt. Wenn die erste Auswahl „false“ ist, evaluiert die Automatisierung die nächste Auswahl. Die Automatisierung evaluiert weiterhin jede Auswahl, bis eine Auswahl als „true“ verarbeitet wird. Die Automatisierung springt dann zu dem für die als „true“ evaluierte Auswahl angegebenen Schritt.

Wenn keine Auswahl als „true“ evaluiert wird, prüft die Automatisierung, ob der Schritt einen default-Wert enthält. Ein Default-Wert definiert einen Schritt, zu dem die Automatisierung springen soll, wenn keine der Auswahlmöglichkeiten als „true“ evaluiert wird. Wenn kein default-Wert für den Schritt definiert ist, verarbeitet die Automatisierung den nächsten Schritt in dem Runbook.

Die Aktion aws:branch unterstützt komplexe Auswahlevaluierungen durch Verwendung einer Kombination der Operatoren And, Not und Or. Weitere Informationen über die Verwendung von aws:branch, mit Beispielrunbooks und Beispielen, die unterschiedliche Operatoren verwenden, finden Sie unter Verwendung bedingter Anweisungen in Runbooks.

Eingabe

Geben Sie eine oder mehrere Choices in einem Schritt an. Die Choices können auf einem Wert basieren, den Sie im Abschnitt Parameters des Runbooks angegeben haben, oder auf einem als Ausgabe von dem vorherigen Schritt generierten dynamischen Wert basieren. Hier ist ein YAML-Beispiel, das einen Parameter evaluiert.

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

Hier ist ein YAML-Beispiel, das die Ausgabe von einem vorherigen Schritt evaluiert.

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

Auswahlen

Ein oder mehrere Ausdrücke, die die Automatisierung evaluieren soll, wenn der nächste zu verarbeitende Schritt bestimmt wird. Auswahlen werden mit einem booleschen Ausdruck evaluiert. Jede Auswahl muss die folgenden Optionen definieren:

• NextStep: Der nächste Schritt in dem Runbook, der zu verarbeiten ist, wenn die betreffende Auswahl „true“ ist.

• Variable: Geben Sie entweder den Namen eines Parameters an, der im Abschnitt Parameters des Runbooks definiert ist, Oder geben Sie ein Ausgabeobjekt von einem vorherigen Schritt im Runbook an. Weitere Informationen zum Erstellen von Variablen für aws:branch finden Sie unter Informationen zum Erstellen der Ausgabevariable.

• Operation: Die Kriterien für die Evaluierung der Auswahl. Die Aktion aws:branch unterstützt die folgenden Operationen:

  Zeichenfolgenoperationen

  • StringEquals

  • EqualsIgnoreCase

  • StartsWith

  • EndsWith

  • Enthält

  Numerische Operationen

  • NumericEquals

  • NumericGreater

  • NumericLesser

  • NumericGreaterOrEquals

  • NumericLesser

  • NumericLesserOrEquals

  Boolesche Operation

  • BooleanEquals

  Wichtig

  Wenn Sie ein Runbook erstellen, validiert das System alle Operationen im Runbook. Wenn eine Operation nicht unterstützt wird, gibt das System einen Fehler aus, wenn Sie versuchen, das Runbook zu erstellen.

Standard

Der Name eines Schritts, zu dem die Automatisierung springen soll, wenn keine der Choices „true“ ist.

Typ: Zeichenfolge

Required: No

Anmerkung

Die Aktion aws:branch unterstützt die Operatoren And, Or und Not. Beispiele für aws:branch unter Verwendung von Operatoren finden Sie unter Verwendung bedingter Anweisungen in Runbooks.