列出运行环境 API：GET /environments-大模型服务平台百炼(Model Studio)-阿里云帮助中心

分页列出当前工作空间下的运行环境，按 created_at 倒序返回。默认不包含已归档项。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /environments

Query 参数

参数	类型	默认	说明
`limit`	int	20	每页数量，最大 100
`page`	string	—	首次不传，后续传上一次响应的 `next_page`
`include_archived`	bool	false	是否包含已归档环境

请求示例

Bash

curl "$AGENTSTUDIO_URL/environments?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Python

for env in client.environments.list(include_archived=False, limit=20):
    print(env.id, env.name)

Java

CursorPage<Environment> page = client.environments().list(EnvironmentListParam.builder()
    .includeArchived(false)
    .limit(20)
    .build());
for (Environment e : page.getData()) System.out.println(e.getId() + " " + e.getName());

响应示例

{
  "data": [
    {
      "id": "env_xxx",
      "type": "environment",
      "name": "data-sandbox",
      "description": "数据分析沙箱",
      "config": {
        "type": "cloud",
        "packages": {"apt": ["ffmpeg"], "pip": ["pandas", "numpy", "matplotlib"]},
        "networking": {"type": "unrestricted"}
      },
      "metadata": {"team": "infra"},
      "scope": "organization",
      "archived_at": null,
      "created_at": "2026-06-16T12:45:34+08:00",
      "updated_at": "2026-06-16T12:45:34+08:00"
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

响应包含 data（Environment 对象数组）与 next_page（下一页游标）。Environment 对象字段如下：

Environment 对象字段

字段	类型	说明
`id`	string	环境 ID，格式 `env_<ULID>`
`type`	string	固定为 `environment`
`name` / `description` / `scope` / `config` / `metadata`	string / object	环境基础属性与完整运行时配置（沙箱类型、预装依赖、网络策略）
`archived_at`	string \| null	归档时间，未归档时为 `null`
`created_at` / `updated_at`	string	创建/最近更新时间，ISO 8601