列出部署运行

通过 OMA API 列出部署运行。

GET /v1/deployment_runs

列出部署运行

cURL

curl --request GET \
  --url http://localhost:38080/v1/deployment_runs \
  --header 'X-Api-Key: <api-key>' \
  --header 'anthropic-beta: <anthropic-beta>' \
  --header 'anthropic-version: <anthropic-version>'

200

{
  "data": [
    {
      "type": "deployment_run",
      "id": "<string>",
      "deployment_id": "<string>",
      "trigger_context": {
        "type": "schedule",
        "scheduled_at": "2023-11-07T05:31:56Z"
      },
      "session_id": "<string>",
      "error": {
        "type": "environment_archived_error",
        "message": "<string>"
      },
      "agent": {
        "type": "agent",
        "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
        "version": 1
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_page": "<string>"
}

每个请求都必须发送 ?beta=true、anthropic-version: 2023-06-01 与 anthropic-beta: managed-agents-2026-04-01。

授权

omaApiKeyomaBearer

X-Api-Key · string · header · 默认值: sk-ant-local-default · 必填

OMA 工作区 API 密钥。

请求头

anthropic-version · string · 必填

anthropic-beta · string · 必填

查询参数

beta · enum<boolean> · 必填

为此接口启用 Beta API 合同，必须为 true。

可用选项: true

limit · integer<int32>

每页最大结果数。默认 20，上限 1000。

page · string

不透明的分页游标。传入上一个响应中的 next_page。无效或过期的游标返回 400。

deployment_id · string

过滤到特定部署。省略时列出工作区中的所有部署。按不存在的 deployment_id 过滤会返回 200 和空数据。

trigger_type · enum<string>

按触发方式过滤运行。省略则返回所有运行。 触发部署运行的因素。

可用选项: schedule, manual

has_error · boolean

过滤条件：true 表示 error 非 null 的 run，false 表示 session_id 非 null 的 run。省略则返回全部。

created_at[gte] · string<date-time>

返回在此时间或之后创建的运行（含该时间）。 RFC 3339 格式的时间戳

created_at[lte] · string<date-time>

返回在此时间或之前创建的运行（含该时间）。 RFC 3339 格式的时间戳

created_at[gt] · string<date-time>

返回严格在此时间之后创建的运行（不含该时间）。 RFC 3339 格式的时间戳

created_at[lt] · string<date-time>

返回严格在此时间之前创建的运行（不含该时间）。 RFC 3339 格式的时间戳

响应

200

application/json

请求成功。

部署运行的分页列表。按 created_at 降序排列（最新的在前）。

data · object[] · 必填

部署运行列表。

Show child attributes

next_page · string | null

下一页的不透明游标。没有更多结果时为 null。