Choice ワークフローの状態

Choice 状態 ("Type": "Choice") はステートマシンに条件付きロジックを追加します。

共通状態フィールドの大半に加えて、Choice 状態には次の追加フィールドが含まれます。

選択ルール (JSONata)

Choice 状態には、値が Choice Rules の空でない配列であるChoicesフィールドが必要です。JSONata を使用する場合、次のフィールドが含まれます。

次の例では、数値が 1 と等しいかどうかを確認します。

{
  "Condition": "{% $foo = 1 %}",
  "Next": "NumericMatchState"
}

次の例では、type変数が と等しいかどうかをチェックしますlocal。

{
  "Condition": "{% $type = 'local' %}",
  "Next": "StringMatchState"
}

次の例では、文字列が MyStringABC を超過しているかどうかを確認します。

{
  "Condition": "{% $foo > 'MyStringABC' %}",
  "Next": "StringGreaterMatchState"
}

次の例では、文字列が null でないかどうかを確認します。

{
 "Condition" : "{% $possiblyNullValue != null and $possiblyNullValue = 42 %}",
 "Next": "NotNullAnd42"
}

選択ルール (JSONPath)

Choice 状態には、値が Choice Rules の空でない配列であるChoicesフィールドが必要です。JSONPath を使用する場合、次のフィールドが含まれます。

次の例では、数値が 1 と等しいかどうかを確認します。

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

次の例では、文字列が MyString と等しいかどうかを確認します。

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

次の例では、文字列が MyStringABC を超過しているかどうかを確認します。

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

次の例では、文字列が null かどうかを確認します。

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

次の例は、IsPresent 選択ルール が先行しているため、$.keyThatMightNotExist が 存在する場合は、StringEquals ルールのみが評価される方法を示しています。

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

次の例では、ワイルドカードを含むパターンが一致するかどうかを確認します。

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

次の例では、タイムスタンプが 2001-01-01T12:00:00Z と等しいかどうかを確認します。

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

次の例では、可変を状態の入力の別の値と比較します。

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

Step Functions は Choices フィールドにリストされた順序で各選択ルールを検討します。次に、最初の選択ルールの Next フィールドで指定された状態に遷移します。ここで、変数は比較演算子に従って値と一致します。

次の比較演算子がサポートされています。

これらの演算子のそれぞれで、対応する値が適切なタイプ (文字列、数値、ブール値、またはタイムスタンプ) である必要があります。Step Functions では、数値フィールドと文字列値の一致を試みません。ただし、タイムスタンプフィールドは論理的に文字列であるため、タイムスタンプとみなされるフィールドを StringEquals コンパレータで一致させることはできます。