千问办公企业旗舰版开发者文档:查询全部计划执行记录。
认证方式见APP开发者文档 → 认证接入。
仅查询当前用户的Session托管执行,包含已软删除计划的流水。支持 task_id、status、run_type、from/to 过滤;使用 limit/offset 分页,按 scheduled_at、id 倒序。时间窗口默认最近90天,from包含、to不包含,最长366天;可指定更早的历史窗口。这是查询范围,不是数据保留期限,不删除历史。manual 包括立即执行和重跑,重跑由 origin_execution_id 区分。
401:缺少有效IAM入口身份;404:资源不存在或非本人;409:计划暂停或原执行尚未结束等状态冲突;422:参数、时间范围、请求体或幂等键无效;503:Session计划组件未启用。部分更新恢复已消费单次任务返回400。错误体沿用Session统一中间件。
202 表示执行已接收并等待派发,不表示沙箱或 Agent 已启动。
- 模块:计划任务
- 接口: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
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items | array/null | 是 | 本页记录数组,无记录时为空数组 |
| items[].dispatch_id | string | 是 | 内部派发标识,不是会话查询地址 |
| items[].error_message | string | 是 | 执行错误说明,无错误时为空字符串 |
| items[].finished_at | string (date-time) | 否 | 执行结束时间,尚未结束时省略 |
| items[].fired_at | string (date-time) | 否 | 该执行写入待派发队列的时间 |
| items[].id | string | 是 | 本次执行 UUID。 |
| items[].origin_execution_id | string | 否 | 重跑的原执行 ID;非重跑时省略 |
| items[].origin_scheduled_at | string (date-time) | 否 | 重跑原执行的分区时间;非重跑时省略 |
| items[].owner | object | 是 | 服务端记录的任务归属,调用方不可修改 |
| items[].owner.org_id | string | 否 | 归属企业 ID,未设置时省略 |
| items[].owner.team_id | string | 否 | 归属团队 ID,未设置时省略 |
| items[].owner.user_id | string | 是 | IAM 用户 ID |
| items[].run_type | string | 是 | 运行类型:scheduled 自动触发;manual 手动执行或重跑 |
| items[].scheduled_at | string (date-time) | 是 | 执行对应的完整日期时间;重跑请求须使用原记录返回值 |
| items[].status | string | 是 | 执行状态:fired、running、success、failed、cancelled、timeout |
| items[].target | object | 是 | 会话运行配置;PATCH 提供时完整替换 |
| items[].target.kind | string | 是 | trigger 为 at/cron/every;target 固定为 cloud_session |
| items[].target.payload | object | 是 | 创建会话使用的运行参数 |
| items[].target.payload.agent_id | string | 否 | 可选 Agent 标识 |
| items[].target.payload.mode | string | 否 | 用户选择的运行档位 |
| items[].target.payload.prompt | string | 是 | 提交给会话的任务内容 |
| items[].target.payload.session_name | string | 否 | 会话名称,未命名时可为空 |
| items[].target.payload.delivery_mode | string | 否 | 新建及更新仅允许省略或 isolated,每次触发新建会话;历史执行快照可能保留 bound |
| items[].target.payload.session_id | string | 否 | 仅历史绑定快照可能返回;新建及更新必须省略 |
| items[].target.payload.files | array | 否 | 附件引用数组,每项含必填 oss_id、可选 name/mime_type;通过现有文件服务复制至工作区 |
| items[].task_id | string | 是 | 计划任务 ID |
| items[].task_name_snapshot | string | 是 | 触发时保存的任务名称 |
| items[].trigger | object | 是 | 触发规则;PATCH 提供时完整替换 |
| items[].trigger.kind | string | 是 | trigger 为 at/cron/every;target 固定为 cloud_session |
| items[].trigger.spec | object | 是 | 触发规则配置 |
| items[].trigger.spec.expr | string | 否 | cron 五段表达式:分、时、日、月、周 |
| items[].trigger.spec.fire | string (date-time) | 否 | at 单次触发时间;创建或修改触发规则时须为未来时间,历史快照可为过去时间 |
| items[].trigger.spec.interval_ns | integer | 否 | every 必填;1分钟至365天,单位纳秒,存储规范化到毫秒 |
| items[].trigger.spec.start_from | string (date-time) | 否 | every 必填;RFC3339 起算时间,可在过去;按固定间隔推进至未来 |
| items[].trigger.spec.rest_day | object | 否 | 日历过滤配置;不支持启用 |
| items[].trigger.spec.rest_day.enabled | boolean | 是 | 只允许 false |
| items[].trigger.spec.rest_day.region | string | 否 | 日历区域保留字段;不参与调度 |
| items[].trigger.spec.rest_day.skip_on | string | 否 | 日历规则保留字段;不参与调度 |
| items[].trigger.spec.tz | string | 否 | cron 的 IANA 时区,省略时为 UTC |
| limit | integer (int64) | 是 | 每页数量,默认 20,范围 1–100 |
| offset | integer (int64) | 是 | 跳过记录数,默认 0,非负整数 |