千问办公企业旗舰版开发者文档:查询计划执行记录。
认证方式见APP开发者文档 → 认证接入。
仅原Owner可读取执行流水,任务软删除后仍可查询。记录是一次触发的执行快照,不等同于当前Task配置或会话事件历史。
接口只消费可信入口的当前用户;需启用Session计划组件且依赖就绪。支持单次与周期计划。
执行终态目前包括success、failed、cancelled、timeout;客户端应容忍新增状态。scheduled_at是计划触发时刻,fired_at是实际开始时刻,finished_at是结束时刻。target/trigger和任务名称是该次执行的快照。lease_token、派发重试计数等内部领取字段不对外序列化。响应没有session_id字段,不把dispatch_id自行转换为会话地址。
当前恢复已消费单次任务的拒绝是400 OPERATION_NOT_ALLOWED;不要把它当作任务成功恢复。错误体沿用Session现有运行时中间件,不套用管理后台错误码或生成器默认problem+json字段。保存trace_id排查,移除用户凭据。
- 模块:计划任务
- 接口:GET
/api/openapi/app/v1/scheduler/tasks/{task_id}/executions - operationId:
list-single-scheduled-task-executions
接口说明
仅原Owner可读取执行流水,任务软删除后仍可查询。记录是一次触发的执行快照,不等同于当前Task配置或会话事件历史。
接口只消费可信入口的当前用户;需启用Session计划组件且依赖就绪。支持单次与周期计划。
请求头
| 参数/字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| Content-Type | header | string | JSON body时 | application/json |
请求参数
| 参数/字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string (uuid) | 是 | 所属用户的非零任务UUID |
| limit | query | integer (int64) | 否 | 分页参数default=20;minimum=1;maximum=100 |
| offset | query | integer (int64) | 否 | 分页参数default=0;minimum=0 |
成功响应
HTTP 200
| 参数/字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| items | response | array[object] / null | 是 | 本页记录集合。 |
| items.[].dispatch_id | response | string | 是 | 该次派发标识,不能推断等于Session ID |
| items.[].error_message | response | string | 是 | 执行错误信息;不是Task配置本身的状态 |
| items.[].finished_at | response | string (date-time) | 否 | 执行结束时间,未结束时省略。 |
| items.[].fired_at | response | string (date-time) | 否 | 执行被领取并写入待派发流水的时间。 |
| items.[].run_type | response | string | 是 | scheduled 自动触发;manual 手动执行或重跑。 |
| items.[].origin_execution_id | response | string (uuid) | 否 | 重跑对应的原执行 ID;非重跑时省略。 |
| items.[].origin_scheduled_at | response | string (date-time) | 否 | 原执行的计划时间,与原执行 ID 一起定位记录。 |
| items.[].id | response | string | 是 | 本次执行 UUID。 |
| items.[].owner | response | object | 是 | 服务端保存的归属身份;不由调用方指定 |
| items.[].owner.org_id | response | string | 否 | 归属企业 UUID,未设置时省略。 |
| items.[].owner.team_id | response | string | 否 | 归属团队 UUID,未设置时省略。 |
| items.[].owner.user_id | response | string | 是 | 归属 IAM 用户 UUID。 |
| items.[].scheduled_at | response | string (date-time) | 是 | 本次执行的完整计划时间,亦用于定位执行记录;不是仅时分秒。 |
| items.[].status | response | string | 是 | 执行状态:fired、running、success、failed、cancelled、timeout;容忍未来新增值 |
| items.[].target | response | object | 是 | 本记录保存的执行目标配置,子字段见下。 |
| items.[].target.kind | response | string | 是 | trigger仅at/cron/every,target仅cloud_session;值:cloud_session |
| items.[].target.payload | response | object | 是 | 会话创建所用的运行参数;执行记录中为触发时快照。 |
| items.[].target.payload.agent_id | response | string | 否 | 可选非零UUID,作为已有Agent配置选择 |
| items.[].target.payload.mode | response | string | 否 | 档位选择,最多128字节;不暴露海外模型ID |
| items.[].target.payload.prompt | response | string | 是 | 文本Prompt不能为空或仅空白 |
| items.[].target.payload.session_name | response | string | 否 | 可选,最多255个字符 |
| items.[].target.payload.delivery_mode | response | string | 否 | 新建及更新仅允许省略或 isolated,每次触发新建会话;历史执行快照可能保留 bound |
| items.[].target.payload.session_id | response | string | 否 | 仅历史绑定快照可能返回;新建及更新必须省略 |
| items.[].target.payload.files | response | array | 否 | 附件引用数组,每项含必填 oss_id、可选 name/mime_type;通过现有文件服务复制至工作区 |
| items.[].task_id | response | string | 是 | 所属计划任务 UUID。 |
| items.[].task_name_snapshot | response | string | 是 | 触发时任务名称快照 |
| items.[].trigger | response | object | 是 | 本记录保存的触发规则,子字段见下。 |
| items.[].trigger.kind | response | string | 是 | trigger仅at/cron/every,target仅cloud_session;值:at, cron, every |
| items.[].trigger.spec | response | object | 是 | 与 trigger.kind 对应的规则参数。 |
| items.[].trigger.spec.expr | response | string | 否 | 仅cron必填;标准5字段,不接受描述符或秒字段 |
| items.[].trigger.spec.fire | response | string (date-time) | 否 | 仅at必填;保存的RFC3339触发时刻(UTC毫秒),执行后可为过去时间 |
| items.[].trigger.spec.interval_ns | response | integer | 否 | every 必填;1分钟至365天,单位纳秒,存储规范化到毫秒 |
| items.[].trigger.spec.start_from | response | string (date-time) | 否 | every 必填;RFC3339 起算时间,可在过去;按固定间隔推进至未来 |
| items.[].trigger.spec.rest_day | response | object | 否 | 保留的日历策略结构;本期不启用日历过滤。 |
| items.[].trigger.spec.rest_day.enabled | response | boolean | 是 | rest_day只能false;true拒绝;值:false |
| items.[].trigger.spec.rest_day.region | response | string | 否 | 保留的地区字段;本期不参与调度。 |
| items.[].trigger.spec.rest_day.skip_on | response | string | 否 | 保留的跳过日期策略字段;本期不参与调度。 |
| items.[].trigger.spec.tz | response | string | 否 | 仅cron可用;IANA时区,省略默认UTC |
| limit | response | integer (int64) | 是 | 本次查询的每页数量。 |
| offset | response | integer (int64) | 是 | 本次查询跳过的记录数量。 |
拒绝与排查
| HTTP | 错误语义 |
|---|---|
| 401 | 缺少或无效的可信IAM用户入口身份;不能通过切换身份参数重试 |
| 404 | 任务不存在或非当前用户;除执行流水外,软删除任务也不可读取 |
| 422 | 无效任务ID、分页、请求体、触发规则或目标参数 |
| 503 | Session计划组件未启用或所需服务不可用 |