列出环境

通过 OMA API 列出环境。

GET /v1/environments

列出环境

cURL

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

200

{
  "data": [
    {
      "type": "environment",
      "id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
      "name": "python-data-analysis",
      "description": "包含数据分析包的 Python 环境。",
      "config": {
        "type": "cloud",
        "networking": {
          "type": "limited",
          "allowed_hosts": [
            "api.example.com"
          ],
          "allow_package_managers": true,
          "allow_mcp_servers": false
        },
        "packages": {
          "type": "packages",
          "pip": [
            "pandas",
            "numpy"
          ],
          "npm": [],
          "apt": [],
          "cargo": [],
          "gem": [],
          "go": []
        }
      },
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

每个请求都必须发送 ?beta=true。

授权

omaApiKeyomaBearer

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

OMA 工作区 API 密钥。

请求头

anthropic-beta · string

用于指定要使用的 beta 版本的可选请求头。

要使用多个 beta，请使用逗号分隔的列表（如 beta1,beta2），或为每个 beta 分别指定该请求头。

anthropic-version · string

你想使用的 OMA API 版本。

在此处阅读更多关于版本控制和我们版本历史的信息。

查询参数

beta · enum<boolean> · 必填

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

可用选项: true

limit · integer · 默认值: 20

要返回的环境最大数量

必填范围: 1 <= x <= 1000

page · string | null

来自上一个响应用于分页的不透明游标。传入上一个响应中的 next_page 值。

include_archived · boolean · 默认值: false

在响应中包含已归档的环境

响应

200

application/json

成功的响应

列出环境时的响应。

该响应模型使用不透明的基于游标的分页。将 page 查询参数设置为 next_page 的值即可获取下一页。

data · Environment · object[] · 必填

环境列表。

Show child attributes

next_page · string | null · 必填

用于获取下一页结果的令牌。如果为 null，则表示没有更多结果。请在下一次请求中将该值传入 page 参数。

示例:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="