运行历史查询规则¶
两列表都要求路径工作区与X-Workspace-ID一致。ID不能是空字符串,不能有首尾空白、超过128字节或含斜线/反斜线;任务路径ID不等于运行ID。
条件 |
已核实现 |
|---|---|
任务范围 |
由任务历史路径的automation_task_id给出;工作区列表不读取同名query参数。 |
状态 |
queued、running、input_required、pending_approval、succeeded、failed、canceled、expired;非空无效值400。 |
时间 |
created_at>=created_from且created_at<created_to;RFC3339并按URL编码保留时区偏移。 |
区间顺序 |
当前未单独检查from<to;倒置/相等区间不能当参数校验成功的业务证明。 |
页大小 |
普通常规输入下,省略/0/负值默认50,大于200封顶200。 |
偏移 |
省略默认0、负数归0;不是cursor。 |
排序 |
created_at降序、id升序;运行事件则是时间正序,不混用。 |
未匹配 |
items=[]、total=0。任务路径不先验证父任务存在,未匹配也可200。 |
整数转换的错误当前未被handler检查。普通非整数字符串可能归零,但溢出依赖Go整型转换结果,不能统一承诺所有无效数字都归默认值或都400;正式调用只传范围内整数。未知query参数不形成筛选。
按生效offset+limit继续分页,以空页或达到total停止;即使某页少于limit也不要仅凭页条数推全量结束。并发写入/状态变化时,按运行ID去重并根据业务窗口重新核对;这不是固定快照查询。
最后更新于