千问办公企业旗舰版开发者文档:查询计划关联会话。
认证方式见APP开发者文档 → 认证接入。
查询计划产生的、当前用户拥有的未删除主会话;根据持久化的任务/执行关联验证,不接受调用方声明的归属。任务已软删除时仍能读取保留的会话,任务不存在或非本人返回404。按执行时间、会话ID倒序;limit/offset分页。只返回已实际创建的会话,尚未派发或创建失败的执行仍从执行记录接口查询。
401:缺少有效IAM入口身份;404:资源不存在或非本人;409:计划暂停或原执行尚未结束等状态冲突;422:参数、时间范围、请求体或幂等键无效;503:Session计划组件未启用。部分更新恢复已消费单次任务返回400。错误体沿用Session统一中间件。
202 表示执行已接收并等待派发,不表示沙箱或 Agent 已启动。
- 模块:计划任务
- 接口: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
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items | array/null | 是 | 本页记录数组,无记录时为空数组 |
| items[].pinned | boolean | 是 | 该任务会话分组的置顶偏好 |
| items[].run_at | string (date-time) | 是 | 关联执行的完整 scheduled_at 日期时间 |
| items[].session_id | string | 是 | 已创建且属于当前用户的会话 ID |
| items[].session_name | string/null | 是 | 会话名称,未命名时可为空 |
| items[].status | string | 是 | 执行状态:fired、running、success、failed、cancelled、timeout |
| limit | integer (int64) | 是 | 每页数量,默认 20,范围 1–100 |
| offset | integer (int64) | 是 | 跳过记录数,默认 0,非负整数 |