État du flux de travail en attente

Un état Wait ("Type": "Wait") empêche la machine d'état de continuer à fonctionner pendant une durée spécifiée. Vous pouvez choisir une durée relative, spécifiée en secondes à partir du moment où l'état commence, ou une heure de fin absolue, spécifiée comme un horodatage.

Outre les champs d'état courants, les états Wait ont l'un des champs suivants.

Seconds

Une durée d'attente (en secondes) avant le début de l'état spécifié dans le champ Next. Vous devez spécifier l'heure sous forme de valeur entière positive comprise entre 0 et 99999999.

Timestamp

Une durée d'attente absolue avant le début de l'état spécifié dans le champ Next.

Les horodatages doivent être conformes au RFC3339 profil de ISO 8601, avec les restrictions supplémentaires selon lesquelles une majuscule T doit séparer les parties de date et d'heure, et une majuscule Z doit indiquer qu'aucun décalage de fuseau horaire numérique n'est présent, par exemple. 2024-08-18T17:33:00Z

Note

Actuellement, si vous spécifiez le temps d'attente sous forme d'horodatage, Step Functions prend en compte la valeur temporelle maximale en secondes et tronque les millisecondes.

SecondsPath

Une durée d'attente (en secondes) avant le début de l'état spécifié dans le champ Next, spécifiée à l'aide d'un chemin à partir des données d'entrée de l'état.

Vous devez spécifier une valeur entière pour ce champ.

TimestampPath

Une durée d'attente absolue avant le début de l'état spécifié dans le champ Next, spécifiée à l'aide d'un chemin à partir des données d'entrée de l'état.

Note

Vous devez spécifier exactement Seconds, Timestamp, SecondsPath ou TimestampPath. En outre, le temps d'attente maximal que vous pouvez spécifier pour les flux de travail standard et les flux de travail express est d'un an et cinq minutes respectivement.

Exemples d'état Wait

L'état Wait suivant introduit un retard de dix secondes dans une machine d'état.

"wait_ten_seconds": {
  "Type": "Wait",
  "Seconds": 10,
  "Next": "NextState"
}

Dans l'exemple suivant, l'WaitÉtat attend une heure absolue : le 14 mars 2024, à 1 h 59 du matin. UTC

"wait_until" : {
  "Type": "Wait",
  "Timestamp": "2024-03-14T01:59:00Z",
  "Next": "NextState"
}

La durée d'attente n'a pas besoin d'être codée en dur. Par exemple, avec les données d'entrée suivantes :

{
  "expirydate": "2024-03-14T01:59:00Z"
}

Vous pouvez sélectionner la valeur « expirydate » de l'entrée à l'aide d'un chemin de référence pour la sélectionner dans les données d'entrée.

"wait_until" : {
    "Type": "Wait",
    "TimestampPath": "$.expirydate",
    "Next": "NextState"
}