采用部分更新语义:传入的字段会被更新,未传字段保留原值。运行中会话使用绑定时的快照,不受影响;新会话使用更新后的环境。config.type 不可变,传入异于原值将报错;config.packages 与 metadata 传入即整体替换原值。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
POST /environments/{environment_id}
语义
采用部分更新语义:请求体中传入的字段会被更新,未传字段保留原值。已绑定该环境的运行中会话使用绑定时的快照,不受更新影响;新会话使用更新后的环境。
config.type不可变,传入异于原值将报错。config.packages传入即整体替换原值(含子键apt、pip等),未列出的包将被移除。metadata传入即整体替换原值,不做键级合并。
请求体
字段同创建 Environment的请求体一节,仅传入需更新的字段。
请求示例
响应示例
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 环境 ID |
type | string | 固定为 environment |
name / description / scope / config / metadata | string / object | 更新后的环境配置;未传入字段保留原值 |
archived_at | string / null | 归档时间,未归档时为 null |
created_at / updated_at | string | 创建 / 最近更新时间,ISO 8601 |
request_id | string | 本次请求的唯一标识 |