État du flux de travail de choix

Un Choice state ("Type": "Choice") ajoute une logique conditionnelle à une machine à états.

Outre la plupart des champs d'état courants, les Choice états contiennent les champs supplémentaires suivants.

Règles Choice

Un Choice état doit avoir un Choices champ dont la valeur est un tableau non vide. Chaque élément de ce tableau est un objet appelé Choice Rule, qui contient les éléments suivants :

L'exemple suivant vérifie si la valeur numérique est égale à 1.

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

L'exemple suivant vérifie si la chaîne est égale à MyString.

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

L'exemple suivant vérifie si la chaîne est supérieure à MyStringABC.

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

L'exemple suivant vérifie si la chaîne est nulle.

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

L'exemple suivant montre comment la StringEquals règle n'est évaluée que lorsqu'elle $.keyThatMightNotExist existe en raison de la règle de IsPresent choix précédente.

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

L'exemple suivant vérifie si un modèle comportant un caractère générique correspond.

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

L'exemple suivant vérifie si l'horodatage est égal à 2001-01-01T12:00:00Z.

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

L'exemple suivant compare une variable avec une autre valeur de l'entrée d'état.

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

Step Functions examine chacune des règles de choix dans l'ordre indiqué dans le Choices champ. Ensuite, il passe à l'état spécifié dans le champ Next de la première règle Choice dans lequel la variable correspond à la valeur en fonction de l'opérateur de comparaison.

Les opérateurs de comparaison suivants sont pris en charge :

Pour chacun de ces opérateurs, la valeur correspondante doit être du type approprié : chaîne, nombre, booléen ou horodatage. Step Functions n'essaie pas de faire correspondre un champ numérique à une valeur de chaîne. Cependant, étant donné que les champs d'horodatage sont logiquement des chaînes, il est possible qu'un champ considéré comme un horodatage puisse être rapproché par un comparateur StringEquals.

Exemple d'état Choice

Voici un exemple d'état Choice et des autres états auquel il est possible de passer.

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

Dans cet exemple, la machine d'état commence par la valeur d'entrée suivante :

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

Step Functions passe à l'ValueInTwentiesétat, en fonction du value champ.

S'il n'y a aucune correspondance pour l'état Choice et ses Choices, l'état fourni dans le champ Default est exécuté à la place. Si l'état Default n'est pas spécifié, l'exécution échoue avec une erreur.