文档中心

火山方舟

Environments

删除环境

DELETE https://ark.cn-beijing.volces.com/api/v3/environments/{environment_id}

永久删除当前项目中指定的 Environment。仅当该 Environment 不再关联任何未删除的 Session 时才能删除；status 为 terminated（已终止）或 archived_at 已有值（已归档）的 Session 仍需先删除。

删除条件

只要 Environment 仍关联未删除的 Session，服务端就会返回 HTTP 400 InvalidAction。status 为 terminated（已终止）或 archived_at 已有值（已归档）的 Session 仍计入关联关系；请先删除所有关联 Session，再删除 Environment。

删除操作不可撤销。重复删除已不存在的 Environment 会返回 HTTP 404 InvalidEnvironment.NotFound；超时重试时，可将该结果视为资源已经删除。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

environment_id string 必选 | 环境 ID

响应参数

id string | 环境 ID

type string | 对象类型

删除环境

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body -X DELETE "https://ark.cn-beijing.volces.com/api/v3/environments/<ENVIRONMENT_ID>" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
  "id": "env-example",
  "type": "environment_deleted"
}

最近更新时间：2026.10.30 21:22:47

这个页面对您有帮助吗？

有用

无用