Skip to main content

查询计划会话分组

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

认证方式见APP开发者文档 → 认证接入。
  • 模块:计划任务
  • 接口: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

字段类型必填说明
itemsarray/null是本页记录数组,无记录时为空数组
items[].latest_run_atstring (date-time)是分组可见会话中最近一次执行时间
items[].latest_statusstring是最近可见会话所对应的执行状态
items[].session_countinteger (int64)是该任务可见会话数量(排除已删除和子会话)
items[].task_deletedboolean是当前任务是否已软删除
items[].task_enabledboolean是当前任务是否启用且未删除
items[].task_idstring是计划任务 ID
items[].task_namestring是当前任务名称
limitinteger (int64)是每页数量,默认 20,范围 1–100
offsetinteger (int64)是跳过记录数,默认 0,非负整数

错误与边界

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