Workflow-Status „Auswahl“

Ein Choice Status ("Type": "Choice") fügt einer Zustandsmaschine bedingte Logik hinzu.

Zusätzlich zu den meisten gängigen Statusfeldern enthält Choice states die folgenden zusätzlichen Felder.

Auswahlregeln

Ein Choice Bundesstaat muss ein Choices Feld haben, dessen Wert ein nicht leeres Array ist. Jedes Element in diesem Array ist ein Objekt namens Choice Rule, das Folgendes enthält:

Im folgenden Beispiel wird geprüft, ob der numerische Wert gleich 1 ist.

{
  "Variable": "$.foo",
  "NumericEquals": 1,
  "Next": "FirstMatchState"
}

Im folgenden Beispiel wird geprüft, ob die Zeichenfolge gleich MyString ist.

{
  "Variable": "$.foo",
  "StringEquals": "MyString",
  "Next": "FirstMatchState"
}

Im folgenden Beispiel wird geprüft, ob die Zeichenfolge größer als MyStringABC ist.

{
  "Variable": "$.foo",
  "StringGreaterThan": "MyStringABC",
  "Next": "FirstMatchState"
}

Im folgenden Beispiel wird geprüft, ob die Zeichenfolge Null ist.

{
 "Variable": "$.possiblyNullValue",
 "IsNull": true
}

Das folgende Beispiel zeigt, wie die StringEquals Regel nur ausgewertet wird, wenn sie aufgrund der vorherigen IsPresent Auswahlregel $.keyThatMightNotExist existiert.

"And": [
 {
 "Variable": "$.keyThatMightNotExist",
 "IsPresent": true
 },
 {
 "Variable": "$.keyThatMightNotExist",
 "StringEquals": "foo"
 }
]

Im folgenden Beispiel wird geprüft, ob ein Muster mit einem Platzhalter übereinstimmt.

{
 "Variable": "$.foo",
 "StringMatches": "log-*.txt"
}

Im folgenden Beispiel wird geprüft, ob der Zeitstempel gleich 2001-01-01T12:00:00Z ist.

{
  "Variable": "$.foo",
  "TimestampEquals": "2001-01-01T12:00:00Z",
  "Next": "FirstMatchState"
}

Im folgenden Beispiel wird eine Variable mit einem anderen Wert aus der Statuseingabe verglichen.

{
 "Variable": "$.foo",
 "StringEqualsPath": "$.bar"
}

Step Functions untersucht jede der Auswahlregeln in der Reihenfolge, die im Choices Feld aufgeführt ist. Anschließend wechselt es in den Zustand, der im Feld Next der ersten Auswahlregel angegeben ist, in der die Variable mit dem Wert entsprechend dem Vergleichsoperator übereinstimmt.

Die folgenden Vergleichsoperatoren werden unterstützt:

Für jeden dieser Operatoren muss der entsprechende Wert vom entsprechenden Typ sein: Zeichenfolge, Zahl, Boolean oder Zeitstempel. Step Functions versucht nicht, ein numerisches Feld einem Zeichenkettenwert zuzuordnen. Da Zeitstempelfelder jedoch logisch gesehen Zeichenfolgen sind, ist es möglich, dass ein Feld, das als Zeitstempel gilt, mit einem Vergleichsoperator StringEquals übereinstimmt.

Beispiel für den Auswahlzustand

Es folgt ein Beispiel für einen Choice-Zustand und andere Zustände, in die er übergeht.

"ChoiceStateX": {
  "Type": "Choice",
  "Choices": [
    {
      "Not": {
        "Variable": "$.type",
        "StringEquals": "Private"
      },
      "Next": "Public"
    },
    {
      "Variable": "$.value",
      "NumericEquals": 0,
      "Next": "ValueIsZero"
    },
    {
      "And": [
        {
          "Variable": "$.value",
          "NumericGreaterThanEquals": 20
        },
        {
          "Variable": "$.value",
          "NumericLessThan": 30
        }
      ],
      "Next": "ValueInTwenties"
    }
  ],
  "Default": "DefaultState"
},

"Public": {
  "Type" : "Task",
  "Resource": "arn:aws:lambda:us-east-1:123456789012:function:Foo",
  "Next": "NextState"
},

"ValueIsZero": {
  "Type" : "Task",
  "Resource": "arn:aws:lambda:us-east-1:123456789012:function:Zero",
  "Next": "NextState"
},

"ValueInTwenties": {
  "Type" : "Task",
  "Resource": "arn:aws:lambda:us-east-1:123456789012:function:Bar",
  "Next": "NextState"
},

"DefaultState": {
  "Type": "Fail",
  "Cause": "No Matches!"
}

In diesem Beispiel beginnt der Zustandsautomat mit folgendem Eingabewert.

{
  "type": "Private",
  "value": 22
}

Step Functions wechselt je nach value Feld in den ValueInTwenties Status.

Wenn der Zustand Choice keine Übereinstimmungen für seine Choices hat, wird stattdessen der im Feld Default bereitgestellte Zustand ausgeführt. Wenn der Zustand Default nicht angegeben ist, schlägt die Ausführung fehl.