Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Choice 工作流程状态

Choice 状态 ("Type": "Choice") 向状态机添加条件逻辑。

除了大多数常用状态字段之外，Choice 状态还包含以下额外字段。

Choice Rule（JSONata）

Choice 状态必须有一个值为非空 Choice Rule 数组的 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"
}

以下示例显示了一种Choice状态，其每个规则Assign块根据匹配的条件设置不同的变量：

{
  "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字段：

这两个展示位置在运行时是相互排斥的。如果选择规则匹配，Step Functions 将仅评估该规则的Assign字段，而不计算顶级Assign字段。Assign只有当没有匹配的选择规则并且工作流程转换到Default状态时，Step Functions 才会评估顶层。

以下示例显示了两个展示位置。

{
  "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 Rule（JSONPath）

Choice 状态必须有一个值为非空 Choice Rule 数组的 Choices 字段，使用 JSONPath 时，该数组包含以下字段：

以下示例检查数值是否等于 1。

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

以下示例检查字符串是否等于 MyString。

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

以下示例检查字符串是否大于 MyStringABC。

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

以下示例检查字符串是否为空。

{
 "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 运算符匹配。