千问办公企业旗舰版开发者文档:查询计划会话分组。
认证方式见APP开发者文档 → 认证接入。
按任务聚合当前用户未删除的计划主会话,返回任务名称、启用/删除标记、会话数及最近会话执行状态。没有可见会话的任务不产生分组;任务软删除后,只要会话仍保留,分组仍可见并标记 task_deleted。按 latest_run_at、task_id 倒序,使用 limit/offset 分页。
401:缺少有效IAM入口身份;404:资源不存在或非本人;409:计划暂停或原执行尚未结束等状态冲突;422:参数、时间范围、请求体或幂等键无效;503:Session计划组件未启用。部分更新恢复已消费单次任务返回400。错误体沿用Session统一中间件。
202 表示执行已接收并等待派发,不表示沙箱或 Agent 已启动。
- 模块:计划任务
- 接口:GET
/api/openapi/app/v1/scheduler/session-groups - operationId:
list-scheduled-session-groups
接口说明
按任务聚合当前用户未删除的计划主会话,返回任务名称、启用/删除标记、会话数及最近会话执行状态。没有可见会话的任务不产生分组;任务软删除后,只要会话仍保留,分组仍可见并标记 task_deleted。按 latest_run_at、task_id 倒序,使用 limit/offset 分页。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit (query) | integer (int64) | 否 | default=20;minimum=1;maximum=100 |
| offset (query) | integer (int64) | 否 | default=0;minimum=0 |
成功响应
HTTP 200
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items | array/null | 是 | 本页记录数组,无记录时为空数组 |
| items[].latest_run_at | string (date-time) | 是 | 分组可见会话中最近一次执行时间 |
| items[].latest_status | string | 是 | 最近可见会话所对应的执行状态 |
| items[].session_count | integer (int64) | 是 | 该任务可见会话数量(排除已删除和子会话) |
| items[].task_deleted | boolean | 是 | 当前任务是否已软删除 |
| items[].task_enabled | boolean | 是 | 当前任务是否启用且未删除 |
| items[].task_id | string | 是 | 计划任务 ID |
| items[].task_name | string | 是 | 当前任务名称 |
| limit | integer (int64) | 是 | 每页数量,默认 20,范围 1–100 |
| offset | integer (int64) | 是 | 跳过记录数,默认 0,非负整数 |