ワークフロー状態を待機する

Wait 状態 ("Type": "Wait") は、ステートマシンの続行を指定された時間遅延させます。相対時間 (状態が開始してからの秒数で指定) と絶対時間 (タイムスタンプで指定) のいずれかを選択できます。

共通状態フィールドに加えて、Wait 状態には次のいずれかのフィールドがあります。

Seconds

Next フィールドで指定された状態の開始を待機する時間 (秒)。時間は 0～99999999 までの正の整数値として指定する必要があります。

Timestamp

Next フィールドで指定された状態の開始を待機する絶対時間。

タイムスタンプは 8601 ISO のRFC3339プロファイルに準拠している必要があります。さらに、大文字は日付と時刻の部分を区切Tる必要があり、大文字は数値タイムゾーンオフセットが存在しないことを示すZ必要があります2024-08-18T17:33:00Z。例えば、。

注記

現在、待機時間をタイムスタンプとして指定すると、Step Functions は時間値を最大秒と見なし、ミリ秒を切り捨てます。

SecondsPath

Next フィールドで指定された状態の開始まで待機する時間 (秒)。状態の入力データから取得されたパスを使用して指定します。

このフィールドには整数値を指定する必要があります。

TimestampPath

Next フィールドで指定された状態の開始まで待機する絶対時間。状態の入力データから取得されたパスを使用して指定します。

注記

Seconds、Timestamp、SecondsPath、または TimestampPath のいずれかちょうど 1 つを指定する必要があります。また、標準ワークフローとエクスプレスワークフローに指定できる最大待機時間は、それぞれ 1 年と 5 分です。

待機状態の例

例えば、次の Wait 状態はステートマシンに 10 秒の遅延を導入します。

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

次の例では、 Wait状態は絶対時間である 2024 年 3 月 14 日午前 1 時 59 分まで待機しますUTC。

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

待機時間をハードコードする必要はありません。例えば、以下の入力データがあるとします。

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

リファレンスパスStep Functions での入力と出力の処理を使用して入力データから選択することで、値「expirydate」を入力データから選択できます。

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