获取环境

通过 OMA API 获取环境。

GET /v1/environments/{environment_id}

获取环境

cURL

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

200

{
  "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"
}

每个请求都必须发送 ?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 版本。

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

路径参数

environment_id · string · 必填

查询参数

beta · enum<boolean> · 必填

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

可用选项: true

响应

200

application/json

成功的响应

适用于云端和自托管环境的统一环境资源。

archived_at · string | null · 必填

环境被归档时的 RFC 3339 时间戳，未归档时为 null

示例:

null

config · CloudConfig · object · 必填

cloud 环境配置。

CloudConfig

SelfHostedConfig

Show child attributes

示例:

{
  "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": []
  }
}

created_at · string · 必填

环境创建时间的 RFC 3339 时间戳

示例:

"2026-03-15T10:00:00Z"

description · string · 必填

用户提供的环境描述

示例:

"包含数据分析软件包的 Python 环境。"

id · string · 必填

环境标识符（例如 'env_...'）

示例:

"env_011CZkZ9X2dpNyB7HsEFoRfW"

metadata · 元数据 · object · 必填

用户提供的元数据键值对

Show child attributes

示例:

{ "key": "value" }

name · string · 必填

环境的人类可读名称

示例:

"python-data-analysis"

type · string · 默认值: environment · 必填

对象类型（始终为 'environment'）

Allowed value: "environment"

示例:

"environment"

updated_at · string · 必填

环境最后更新时间的 RFC 3339 时间戳

示例:

"2026-03-15T10:00:00Z"

scope · enum<string>

此环境的可见性范围。'organization' 表示对所有账号可见。'account' 表示仅对所属账号可见。

可用选项: organization, account