Skip to main content

查询计划关联会话

千问办公企业旗舰版开发者文档:查询计划关联会话。

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

接口说明

查询计划产生的、当前用户拥有的未删除主会话;根据持久化的任务/执行关联验证,不接受调用方声明的归属。任务已软删除时仍能读取保留的会话,任务不存在或非本人返回404。按执行时间、会话ID倒序;limit/offset分页。只返回已实际创建的会话,尚未派发或创建失败的执行仍从执行记录接口查询。

请求参数

字段类型必填说明
task_id (path)string (uuid)是计划任务 ID
limit (query)integer (int64)否default=20;minimum=1;maximum=100
offset (query)integer (int64)否default=0;minimum=0

成功响应

HTTP 200

字段类型必填说明
itemsarray/null是本页记录数组,无记录时为空数组
items[].pinnedboolean是该任务会话分组的置顶偏好
items[].run_atstring (date-time)是关联执行的完整 scheduled_at 日期时间
items[].session_idstring是已创建且属于当前用户的会话 ID
items[].session_namestring/null是会话名称,未命名时可为空
items[].statusstring是执行状态:fired、running、success、failed、cancelled、timeout
limitinteger (int64)是每页数量,默认 20,范围 1–100
offsetinteger (int64)是跳过记录数,默认 0,非负整数

错误与边界

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