获取 Work 队列统计

更新时间:
复制 MD 格式

读取 self-hosted Environment 的队列深度和 worker polling 统计。

GET /api/v1/cloud/environments/{environment_id}/work/stats

返回 self_hosted Environment 的 work 队列统计。

路径参数

参数

类型

说明

environment_id

string

Environment ID,前缀为 env_

请求头

头部

必选

说明

Authorization

Bearer $QODER_PAT

示例请求

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/environments/env_019e64e01a137caf953ac2ac7b42ec5c/work/stats" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "type": "work_queue_stats",
  "depth": 3,
  "pending": 1,
  "oldest_queued_at": "2026-07-01T08:15:01Z",
  "workers_polling": 2
}

响应字段

返回 Work queue stats 对象。

错误码

HTTP

type

触发条件

400

invalid_request_error

Environment 不是 self_hosted

401

authentication_error

PAT 无效或过期

403

permission_error

无权限执行此操作

404

not_found_error

Environment 不存在

注意事项

  • depth 统计当前可 claim 的 queued item。

  • pending 统计最近已投递但尚未 ack 的 queued item。

  • workers_polling 只统计带有 Worker-ID 的 poll 请求。