Wait 工作流程状态 - Amazon Step Functions
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Wait 工作流程状态

管理状态和转换数据

Wait 状态 ("Type": "Wait") 使状态机延迟指定的时间,然后再继续。您可以选择一个相对时间,指定从状态开始后的秒数;也可以选择以时间戳的方式指定绝对结束时间。

除了常用状态字段之外,Wait 状态还具有以下字段之一。

Seconds

启动 Next 字段中指定状态之前等待的时间,以秒为单位。时间必须指定为介于 0 到 99999999 之间的整数值。在 JSONata 状态下,您也可以指定一个 JSONata 表达式,该表达式的计算结果必须为指定范围内的整数。

Timestamp

一个绝对时间,等到该时间后再启动 Next 字段中指定的状态。

时间戳必须遵循 ISO 8601 的 RFC3339 配置文件,并有进一步的限制,需要使用大写 T 分隔日期和时间部分,大写 Z 必须表示没有数字时区偏移,例如 2024-08-18T17:33:00Z

在 JSONata 状态下,您可以指定一个 JSONata 表达式,该表达式生成符合先前要求的字符串。

注意

当前,如果您将等待时间指定为时间戳,Step Functions 会选取秒以内的时间值并截断毫秒。

SecondsPath(可选,仅限 JSONPath)

状态输入数据中指向一个整数值的路径,该值指定继续执行下一状态前的等待时间(以秒为单位)。

TimestampPath(可选,仅限 JSONPath)

状态输入数据中指向一个绝对日期和时间(时间戳)的路径,以此作为继续执行下一状态前的等待时长。

注意

您必须且只能指定以下之一:SecondsTimestampSecondsPathTimestampPath。此外,您可以为标准工作流和快速工作流指定的最长等待时间分别为一年和五分钟。

Wait 状态示例

以下 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" }

您可以使用引用路径从输入中选择“expirydate”值,以便从输入数据选择该值。

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