归档环境
更新时间:2026-11-13
POST
https://api.dumate.cn/api/dma/v1/environments/{environment_id}/archive
本接口用于归档指定的环境(Environment)。
归档后的环境不能再用于创建会话。归档成功后返回环境对象,archived_at 为归档时间。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
environment_id
string
环境标识。
环境不存在时返回 404。
必选
请求结构
POST /api/dma/v1/environments/{environment_id}/archive HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/environments/env_cdf80dd7ee404774/archive" \
--header 'Authorization: Bearer <YOUR_API_KEY>'
返回响应
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
当前恒为空数组,不支持通过 apt 预装软件包。
可选
显示子属性
隐藏子属性
items
string
cargo
array
当前恒为空数组,不支持通过 cargo 预装软件包。
可选
显示子属性
隐藏子属性
items
string
gem
array
当前恒为空数组,不支持通过 gem 预装软件包。
可选
显示子属性
隐藏子属性
items
string
go
array
当前恒为空数组,不支持通过 go 预装软件包。
可选
显示子属性
隐藏子属性
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。
可选
响应示例
{
"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": "2026-11-09T13:37:08Z"
}
评价此篇文章
