翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Choice ワークフローの状態

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

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

Choice ルール (JSONata)

Choice ステートでは、JSONata を使用する場合、Choices フィールドを指定する必要があります。このフィールドには、次のフィールドを含む、1 つ以上の Choice ルールを指定します。

次の例では、数値が 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"
}

次の例は、一致した条件に基づいて異なる変数を設定するルールごとのAssignブロックを持つChoice状態を示しています。

{
  "Type": "Choice",
  "Choices": [
    {
      "Condition": "{% $states.input.category = 'premium' %}",
      "Next": "PremiumPath",
      "Assign": {
        "discount": 20
      }
    },
    {
      "Condition": "{% $states.input.category = 'standard' %}",
      "Next": "StandardPath",
      "Assign": {
        "discount": 5
      }
    }
  ],
  "Default": "DefaultPath",
  "Assign": {
    "discount": 0
  }
}

選択状態で割り当てを使用する

Assign フィールドは、Choice 状態の 2 つのレベルで使用できます。

これら 2 つの配置は、実行時に相互に排他的です。選択ルールが一致した場合、Step Functions はそのルールの Assignフィールドのみを評価し、最上位Assignフィールドは評価しません。Step Functions は、選択ルールが一致しず、ワークフローが Default状態に移行したAssign場合にのみ、最上位レベルを評価します。

次の例は、両方の配置を示しています。

{
  "Type": "Choice",
  "Assign": {
    "outputValue": "{% 'default path taken' %}"
  },
  "Choices": [
    {
      "Condition": "{% $score > 90 %}",
      "Assign": {
        "outputValue": "{% 'high score' %}"
      },
      "Next": "HighScoreState"
    },
    {
      "Condition": "{% $score > 50 %}",
      "Next": "MediumScoreState"
    }
  ],
  "Default": "LowScoreState"
}

この例では、 $scoreが 90 より大きい場合、Step Functions は outputValueを に割り当て"high score"、 に移行しますHighScoreState。最上位レベルAssignは評価されません。ルールが一致しない場合、Step Functions は最上位レベルを評価しAssign、 に移行しますLowScoreState。

Choice ルール (JSONPath)

Choice ステートでは、JSONPath を使用する場合、Choices フィールドを指定する必要があります。このフィールドには、次のフィールドを含む、1 つ以上の Choice ルールを指定します。

次の例では、数値が 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 コンパレータで一致させることはできます。