\n
\n\n
\nPOST
\n\nhttps://api.dumate.cn/api/dma/v1/environments\n
\n本接口用于创建环境（Environment），定义会话运行的沙箱，包括预装软件包。
\n创建成功后返回环境对象，其中 id 为环境标识，创建会话时使用。
权限说明
\n使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
\n请求参数
\n\n
\n\n
\n\n
\n\n
\nHeaders 参数
\n除公共头域外，无其它特殊头域
\n\n
\n\n
\nBody 参数
\n\n
\n\n
\n\n\n
\n\n\nname\n\nstring\n
\n环境名称。
长度：1–256 个字符。
必选
\n\n\n
\n\n\nconfig\n\nobject {2}\n
\n环境配置。
不传时默认创建 type 为 cloud 的环境。
可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\ntype\n\nstring\n
\n环境类型。
可选值：cloud（托管云沙箱）
必选
\n\n\n
\n\n\npackages\n\nobject {2}\n
\n预装软件包，按包管理器分组，值为包名数组。
仅 type 为 cloud 时使用。
可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\nnpm\n\narray\n
\n通过 npm 预装的包名列表。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\npip\n\narray\n
\n通过 pip 预装的包名列表。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\ndescription\n\nstring\n
\n环境描述。
长度：不超过 1024 个字符。
可选
\n\n\n
\n\n\nmetadata\n\nobject\n
\n自定义键值，最多 16 对。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n
\n请求结构
\n\n\n\n
\n\n
\nPOST /api/dma/v1/environments HTTP/1.1\nHost: api.dumate.cn\nAuthorization: Bearer <YOUR_API_KEY>\nContent-Type: application/json示例代码
\n\n\n
\n\n
\n\n
\n\n
\n请求示例
\n\n\n\n
\n\n
\ncurl --location --request POST \"https://api.dumate.cn/api/dma/v1/environments\" \\\n --header 'Authorization: Bearer <YOUR_API_KEY>' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"name\": \"doc-test-env-1109\",\n \"config\": {\n \"type\": \"cloud\",\n \"packages\": {\n \"pip\": [\n \"pandas\"\n ]\n }\n }\n }'返回响应
\n\n
\n\n
\n\n
\n\n
\nHeaders 参数
\n除公共头域外，无其它特殊头域
\n\n
\n\n
\n返回参数
\n\n
\n\n
\n\n\n
\n\n\ntype\n\nstring\n
\n资源类型标识，固定为 environment。
\n可选
\n\n\n
\n\n\nid\n\nstring\n
\n环境标识，env_ 前缀。
\n可选
\n\n\n
\n\n\nname\n\nstring\n
\n环境名称。
\n可选
\n\n\n
\n\n\ndescription\n\nstring\n
\n环境描述；未设置时为 null。
\n可选
\n\n\n
\n\n\nconfig\n\nobject {2}\n
\n环境配置。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\ntype\n\nstring\n
\n环境类型。
可选值：cloud（托管云沙箱）
可选
\n\n\n
\n\n\npackages\n\nobject {7}\n
\n预装软件包，按包管理器分组；未设置的包管理器返回空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\ntype\n\nstring\n
\n子对象类型标识，固定为 packages。
\n可选
\n\n\n
\n\n\napt\n\narray\n
\n通过 apt 预装的包名列表；当前恒为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\ncargo\n\narray\n
\n通过 cargo 预装的包名列表；当前恒为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\ngem\n\narray\n
\n通过 gem 预装的包名列表；当前恒为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\ngo\n\narray\n
\n通过 go 预装的包名列表；当前恒为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\nnpm\n\narray\n
\n通过 npm 预装的包名列表；未设置时为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\npip\n\narray\n
\n通过 pip 预装的包名列表；未设置时为空数组。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nstring\n
\n\n\n\n
\n\n\nmetadata\n\nobject\n
\n自定义键值；未设置时为空对象。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n\n
\n\n\ncreated_at\n\nstring\n
\n创建时间，RFC 3339 格式，UTC。
\n可选
\n\n\n
\n\n\nupdated_at\n\nstring\n
\n最近更新时间，RFC 3339 格式，UTC。
\n可选
\n\n\n
\n\n\narchived_at\n\nstring\n
\n归档时间，RFC 3339 格式，UTC；未归档时为 null。
\n可选
\n\n
\n\n\n
\n\n
\n\n
\n\n
\n响应示例
\n\n\n\n
\n\n
\n{\n \"type\": \"environment\",\n \"id\": \"env_cdf80dd7ee404774\",\n \"name\": \"doc-test-env-1109\",\n \"description\": null,\n \"config\": {\n \"type\": \"cloud\",\n \"packages\": {\n \"type\": \"packages\",\n \"apt\": [],\n \"cargo\": [],\n \"gem\": [],\n \"go\": [],\n \"npm\": [],\n \"pip\": [\n \"pandas\"\n ]\n }\n },\n \"metadata\": {},\n \"created_at\": \"2026-11-09T13:37:07Z\",\n \"updated_at\": \"2026-11-09T13:37:07Z\",\n \"archived_at\": null\n}