Schedule 数据结构

​

Schedule 对象

创建、查询、列表、更新、归档、暂停和恢复接口返回该结构。

​

执行策略

​

触发策略

sinks 的公开格式和约束见创建 Schedule。

​

Schedule Run 对象

手动运行、查询 Run 和列出 Runs 接口返回该结构。 主流程 status 与 IM 投递 push_status 相互独立。Schedule 配置 execution.max_attempts=2 时，同一个 Run 最终可能返回 attempt=2。

​

Identity 启停与排期

Identity 停用期间不启动新的 Schedule 执行，尚未开始的 Run 可能被记录为 skipped；已接受的执行及结果投递会自然完成。重新启用后，周期任务从未来的触发点继续，不补跑停用期间错过的触发；已经过期的一次性触发保留 skipped Run 并按正常规则归档。手动暂停、已归档或已删除的 Schedule 不会因 Identity 启用而恢复，详见启用 Identity。

​

输入版本

initial_events_version 由服务端维护，无需在创建或更新请求中传入。新建 Schedule 为 1；只有规范化后的 initial_events 实际改变时才递增。相同内容更新、修改名称或执行/触发策略不递增；改回曾经使用的内容仍会生成新的版本。存量 Schedule 的当前输入以 1 为基线，不追溯历史版本。 Run 创建时尚未绑定输入；在本次 attempt 首次发送输入前，执行器将匹配的内容和版本绑定到 Run。同一 attempt 的发送重试和恢复沿用该绑定，新的 attempt 可以选用更新后的输入。因此应结合 attempt 理解 Run 的版本，版本存在仅表示已选择输入，不代表运行时已经接收或执行成功。 尚未选择输入的 pending、skipped Run，以及无法确认执行输入的历史 Run，会省略该字段；未知版本不返回 0，也不能用当前 Schedule 的版本补齐。接入方应兼容新增字段，并将缺失版本视为未知。 接入方可在创建或更新 Schedule 后保存 schedule_id、initial_events_version 与输入内容的对应关系，再按 Run 或 Webhook 回调中的版本关联执行输入。当前 Schedule 返回的是最新配置，可能与已经开始执行的 Run 不同。 可通过获取 Schedule Run并传 include_initial_events=true 回查该次所选输入，无需依赖当前 Schedule 的配置。

​

创建来源

source 和 source_session_id 是只读字段，在 v1/v2 的完整 Schedule 和 Schedule Run 响应中始终存在。 来源由服务端记录，不能通过创建或更新请求设置，也不支持按来源筛选。metadata.source 只是可修改的业务元数据，不代表权威来源。 Schedule Run 继承父 Schedule 的来源，与本次手动或自动触发、是否配置 sinks 无关；历史 Run 和已归档 Schedule 的 Run 同样适用。Run 的 session_id 表示本次执行 Session，trigger_context.type 表示本次触发方式。来源 Session 不表示 reuse_session 的执行绑定，内部来源结果投递目标也不作为公开来源。 来源字段是兼容新增的 JSON 字段，客户端应容忍未知字段。服务部署后，历史 Schedule 和 Run 的查询响应也返回来源字段，不需要数据回填。

​

Trigger Context

​

Run Error

status=failed 或 status=skipped 时可能返回 error；status=completed 时为 null。