워크플로 상태 선택

Choice 상태("Type": "Choice")는 조건부 논리를 상태 시스템에 추가합니다.

Choice 상태에는 대부분의 일반 상태 필드 외에도 다음과 같은 필드가 추가로 포함되어 있습니다.

선택 규칙

Choice 상태에는 값이 비어 있지 않은 배열인 Choices 필드가 있어야 합니다. 이 배열의 각 요소는 선택 규칙이라는 객체이며, 이 객체에는 다음이 포함됩니다.

다음은 숫자 값이 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 선택 StringEquals 규칙 때문에 규칙이 $.keyThatMightNotExist 존재할 때만 규칙이 평가되는 방식을 보여줍니다.

"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 연산자와 연결될 수 있습니다.

Choice 상태 예제

다음은 전환될 Choice 상태 및 다른 상태의 예입니다.

"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!"
}

이 예제에서 상태 시스템은 다음 입력 값으로 시작됩니다.

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

Step Functions는 value 필드에 따라 ValueInTwenties 상태로 전환됩니다.

Choice 상태의 Choices에 일치하는 상태가 없으면 Default 필드에 제공된 상태가 대신 실행됩니다. Default 상태가 지정되어 있지 않으면 오류가 표시되며 실행이 실패합니다.