Skip to main content

Cron 触发器

Cron 触发器用于通过定时任务周期性地执行工作流，适合做对账任务、周期性同步、批处理等场景。

配置字段​

在 TriggerDef 中，Cron 类型相关字段包括：

  • cronExpression：Cron 表达式，用于描述触发时间计划（例如 0 */5 * * * ? 表示每 5 分钟执行一次）
  • cronTimezone：时区标识（例如 Asia/Shanghai），用于解析 Cron 表达式
  • cronNextFireAt：下次计划触发时间（只读，由调度器根据表达式和时区计算）

创建与更新行为​

当触发器类型为 CRON 时：

  • 创建时需要提供 cronExpression 与 cronTimezone，以便调度器建立定时任务
  • 更新 cronExpression 或 cronTimezone 会自动重置内部的 cronNextFireAt，由调度器重新计算下一次执行时间

典型的创建与更新接口同其他触发器一致：

  • 创建：POST /linker/workflows/<workflowId>/triggers
  • 更新：PUT /linker/triggers/<triggerId>

只要请求体中的 type 为 CRON，并携带上述字段即可。