更新环境
更新时间：2026-11-13
POST
https://api.dumate.cn/api/dma/v1/environments/{environment_id}
本接口用于更新环境（Environment）配置。
Body 字段均可选，含义同创建环境接口，只需传入要修改的字段。更新成功后返回更新后的环境对象。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
environment_id
string
环境标识。
环境不存在时返回 404。
必选
Body 参数
name
string
环境名称。
长度：1–256 个字符。
可选
description
string
环境描述。
长度：不超过 1024 个字符。
可选
config
object {2}
环境配置，结构同创建环境接口。
可选
显示子属性
隐藏子属性
type
string
环境类型，当前仅支持 cloud（托管云沙箱）。
必选
packages
object {2}
预装软件包，仅支持 pip 和 npm，值为包名数组。
可选
显示子属性
隐藏子属性
npm
array
通过 npm 预装的包名列表。
可选
显示子属性
隐藏子属性
items
string
pip
array
通过 pip 预装的包名列表。
可选
显示子属性
隐藏子属性
items
string
metadata
object
自定义键值，按键合并。
最多 16 对。
可选
显示子属性
隐藏子属性
请求结构
POST /api/dma/v1/environments/{environment_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/environments/env_cdf80dd7ee404774" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"description": "demo environment",
"metadata": {
"team": "doc"
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 environment。
可选
id
string
环境标识，env_ 前缀。
可选
name
string
环境名称。
可选
description
string
环境描述；未设置时为 null。
可选
config
object {2}
环境配置。
可选
显示子属性
隐藏子属性
type
string
环境类型，当前仅支持 cloud（托管云沙箱）。
可选
packages
object {7}
预装软件包，按包管理器分组；未设置的包管理器返回空数组。
可选
显示子属性
隐藏子属性
type
string
资源类型标识，固定为 packages。
可选
apt
array
当前固定返回空数组，不支持预装该包管理器的软件包。
可选
显示子属性
隐藏子属性
items
string
cargo
array
当前固定返回空数组，不支持预装该包管理器的软件包。
可选
显示子属性
隐藏子属性
items
string
gem
array
当前固定返回空数组，不支持预装该包管理器的软件包。
可选
显示子属性
隐藏子属性
items
string
go
array
当前固定返回空数组，不支持预装该包管理器的软件包。
可选
显示子属性
隐藏子属性
items
string
npm
array
通过 npm 预装的包名列表；未设置时为空数组。
可选
显示子属性
隐藏子属性
items
string
pip
array
通过 pip 预装的包名列表；未设置时为空数组。
可选
显示子属性
隐藏子属性
items
string
metadata
object
自定义键值；未设置时为空对象。
可选
显示子属性
隐藏子属性
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
archived_at
string
归档时间，RFC 3339 格式，UTC；未归档时为 null。
可选
响应示例
{
"type": "environment",
"id": "env_cdf80dd7ee404774",
"name": "doc-test-env-1109",
"description": "demo environment",
"config": {
"type": "cloud",
"packages": {
"type": "packages",
"apt": [],
"cargo": [],
"gem": [],
"go": [],
"npm": [],
"pip": [
"pandas"
]
}
},
"metadata": {
"team": "doc"
},
"created_at": "2026-11-09T13:37:07Z",
"updated_at": "2026-11-09T13:37:08Z",
"archived_at": null
}评价此篇文章