Skip to main content

Environment

运行环境 API 提供沙箱配置的完整生命周期管理,包括创建、查询、更新、归档与删除。

创建 Environment

POST /environments

请求体

字段必填类型说明
namestring环境名称
descriptionstring环境用途说明
configobject沙箱配置,含 typecloud)、packages(按 apt/pip/npm 声明预装包)、networking{"type": "unrestricted"}
metadataobject业务自定义键值

请求示例

curl -X POST "$AGENTSTUDIO_URL/environments" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "data-sandbox",
    "description": "数据分析沙箱",
    "config": {
      "type": "cloud",
      "packages": {
        "apt": ["ffmpeg"],
        "pip": ["pandas", "numpy", "matplotlib"]
      },
      "networking": {"type": "unrestricted"}
    }
  }'

获取 Environment

GET /environments/{environment_id}

列出 Environment

GET /environments 分页列出工作空间下的环境,默认不含已归档。

更新 Environment

PATCH /environments/{environment_id}

删除 Environment

DELETE /environments/{environment_id} 硬删除,不可恢复。

归档 Environment

POST /environments/{environment_id}/archive 软归档,已绑定的会话不受影响。