分页查询指定下线任务实际执行到的用户,taskId 指定任务,keyword 按用户信息模糊搜索。
- Scope:
admin.v1.force-logout-tasks.read - 权限项: 强制下线任务读取
- 权限类型: read
- 接口: GET
/api/openapi/v1/force-logout-tasks/{taskId}/execution-users
Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围(subject_scope={"mode":"all"});受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。
仅查询已执行任务及持久化目标用户快照。executed 表示下线命令已生成,不代表客户端已经收到或完成下线。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
taskId | path | string | True | 下线任务标识 |
keyword | query | string | False | 搜索关键词 |
请求示例
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
items | array | 结果列表 |
items[].departments | array | 用户部门快照 |
items[].departments[].id | string | 记录标识 |
items[].departments[].name | string | 名称 |
items[].departments[].path | string | path |
items[].email | string | 用户邮箱 |
items[].employee_no | string | 员工编号 |
items[].user_id | string | 设备所属用户标识 |
items[].user_name | string | 用户姓名 |
page | integer | 页码,从 1 开始 |
page_size | integer | 每页条数,最多 100 |
total | integer | 总记录数 |
错误处理
沿用 {error, detail, code} 错误结构。身份校验失败为 401/403;缺少 Scope 或非全部用户范围为 403;资源不存在为 404;冲突或旧版本为 409;参数不合法为 400/422;依赖不可用为 503。业务错误沿用控制台语义。