Skip to main content

查询全部计划执行记录

千问办公企业旗舰版开发者文档:查询全部计划执行记录。

认证方式见APP开发者文档 → 认证接入。
  • 模块:计划任务
  • 接口:GET/api/openapi/app/v1/scheduler/executions
  • operationId:list-scheduled-executions

接口说明

仅查询当前用户的Session托管执行,包含已软删除计划的流水。支持 task_id、status、run_type、from/to 过滤;使用 limit/offset 分页,按 scheduled_at、id 倒序。时间窗口默认最近90天,from包含、to不包含,最长366天;可指定更早的历史窗口。这是查询范围,不是数据保留期限,不删除历史。manual 包括立即执行和重跑,重跑由 origin_execution_id 区分。

请求参数

字段类型必填说明
limit (query)integer (int64)否default=20;minimum=1;maximum=100
offset (query)integer (int64)否default=0;minimum=0
task_id (query)string (uuid)否计划任务 ID
from (query)string (date-time)否查询起始时间,包含该时刻;默认 90 天前。窗口最长 366 天,这是查询限制,不是数据保留期限。
to (query)string (date-time)否查询结束时间,不包含该时刻;默认当前时间。
status (query)string否执行状态:fired、running、success、failed、cancelled、timeout
run_type (query)string否运行类型:scheduled 自动触发;manual 手动执行或重跑

成功响应

HTTP 200

字段类型必填说明
itemsarray/null是本页记录数组,无记录时为空数组
items[].dispatch_idstring是内部派发标识,不是会话查询地址
items[].error_messagestring是执行错误说明,无错误时为空字符串
items[].finished_atstring (date-time)否执行结束时间,尚未结束时省略
items[].fired_atstring (date-time)否该执行写入待派发队列的时间
items[].idstring是本次执行 UUID。
items[].origin_execution_idstring否重跑的原执行 ID;非重跑时省略
items[].origin_scheduled_atstring (date-time)否重跑原执行的分区时间;非重跑时省略
items[].ownerobject是服务端记录的任务归属,调用方不可修改
items[].owner.org_idstring否归属企业 ID,未设置时省略
items[].owner.team_idstring否归属团队 ID,未设置时省略
items[].owner.user_idstring是IAM 用户 ID
items[].run_typestring是运行类型:scheduled 自动触发;manual 手动执行或重跑
items[].scheduled_atstring (date-time)是执行对应的完整日期时间;重跑请求须使用原记录返回值
items[].statusstring是执行状态:fired、running、success、failed、cancelled、timeout
items[].targetobject是会话运行配置;PATCH 提供时完整替换
items[].target.kindstring是trigger 为 at/cron/every;target 固定为 cloud_session
items[].target.payloadobject是创建会话使用的运行参数
items[].target.payload.agent_idstring否可选 Agent 标识
items[].target.payload.modestring否用户选择的运行档位
items[].target.payload.promptstring是提交给会话的任务内容
items[].target.payload.session_namestring否会话名称,未命名时可为空
items[].target.payload.delivery_modestring否新建及更新仅允许省略或 isolated,每次触发新建会话;历史执行快照可能保留 bound
items[].target.payload.session_idstring否仅历史绑定快照可能返回;新建及更新必须省略
items[].target.payload.filesarray否附件引用数组,每项含必填 oss_id、可选 name/mime_type;通过现有文件服务复制至工作区
items[].task_idstring是计划任务 ID
items[].task_name_snapshotstring是触发时保存的任务名称
items[].triggerobject是触发规则;PATCH 提供时完整替换
items[].trigger.kindstring是trigger 为 at/cron/every;target 固定为 cloud_session
items[].trigger.specobject是触发规则配置
items[].trigger.spec.exprstring否cron 五段表达式:分、时、日、月、周
items[].trigger.spec.firestring (date-time)否at 单次触发时间;创建或修改触发规则时须为未来时间,历史快照可为过去时间
items[].trigger.spec.interval_nsinteger否every 必填;1分钟至365天,单位纳秒,存储规范化到毫秒
items[].trigger.spec.start_fromstring (date-time)否every 必填;RFC3339 起算时间,可在过去;按固定间隔推进至未来
items[].trigger.spec.rest_dayobject否日历过滤配置;不支持启用
items[].trigger.spec.rest_day.enabledboolean是只允许 false
items[].trigger.spec.rest_day.regionstring否日历区域保留字段;不参与调度
items[].trigger.spec.rest_day.skip_onstring否日历规则保留字段;不参与调度
items[].trigger.spec.tzstring否cron 的 IANA 时区,省略时为 UTC
limitinteger (int64)是每页数量,默认 20,范围 1–100
offsetinteger (int64)是跳过记录数,默认 0,非负整数

错误与边界

401:缺少有效IAM入口身份;404:资源不存在或非本人;409:计划暂停或原执行尚未结束等状态冲突;422:参数、时间范围、请求体或幂等键无效;503:Session计划组件未启用。部分更新恢复已消费单次任务返回400。错误体沿用Session统一中间件。 202 表示执行已接收并等待派发,不表示沙箱或 Agent 已启动。