Skip to main content

更新 Environment

采用部分更新语义:传入的字段会被更新,未传字段保留原值。运行中会话使用绑定时的快照,不受影响;新会话使用更新后的环境。config.type 不可变,传入异于原值将报错;config.packages 与 metadata 传入即整体替换原值。

前提

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

接口

POST /environments/{environment_id}

语义

采用部分更新语义:请求体中传入的字段会被更新,未传字段保留原值。已绑定该环境的运行中会话使用绑定时的快照,不受更新影响;新会话使用更新后的环境。
  • config.type 不可变,传入异于原值将报错。
  • config.packages 传入即整体替换原值(含子键 apt、pip 等),未列出的包将被移除。
  • metadata 传入即整体替换原值,不做键级合并。

请求体

字段同创建 Environment的请求体一节,仅传入需更新的字段。

请求示例

curl -X POST "$AGENTSTUDIO_URL/environments/env_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "data-sandbox",
    "description": "数据分析沙箱(更新)",
    "scope": "organization",
    "metadata": {"team": "infra"},
    "config": {
      "type": "cloud",
      "packages": {"apt": ["ffmpeg"], "pip": ["pandas", "numpy", "scikit-learn"]},
      "networking": {"type": "unrestricted"}
    }
  }'

响应示例

{
  "id": "env_xxx",
  "type": "environment",
  "name": "data-sandbox",
  "description": "数据分析沙箱(更新)",
  "config": {
    "type": "cloud",
    "packages": {"apt": ["ffmpeg"], "pip": ["pandas", "numpy", "scikit-learn"]},
    "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:52:31+08:00",
  "request_id": "xxx"
}
响应为更新后的 Environment 对象。字段如下:

响应字段

字段类型说明
idstring环境 ID
typestring固定为 environment
name / description / scope / config / metadatastring / object更新后的环境配置;未传入字段保留原值
archived_atstring / null归档时间,未归档时为 null
created_at / updated_atstring创建 / 最近更新时间,ISO 8601
request_idstring本次请求的唯一标识
Managed Agent API
Flow Agent API
Sandbox API
RAG API
长期记忆
ParseX API
Security API
框架集成
Assistant API(下线中)