归档 Environment

更新时间:
复制 MD 格式

软归档:环境保留但默认不出现在列表中,仍可被查询。已绑定的会话继续可用。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证

接口

POST /environments/{environment_id}/archive

语义

软归档:响应返回完整 environment 对象,archived_at 字段被填入归档时间。归档后默认不出现在列表中(除非 include_archived=true),仍可被 GET 查询。已绑定的会话继续可用。

请求示例

curl -X POST "$AGENTSTUDIO_URL/environments/env_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
client.environments.archive("env_xxx")
client.environments().archive("env_xxx");

响应示例

{
  "id": "env_xxx",
  "type": "environment",
  "name": "data-sandbox",
  "description": "数据分析沙箱",
  "config": {
    "type": "cloud",
    "packages": {"apt": ["ffmpeg"], "pip": ["pandas", "numpy", "matplotlib"]},
    "networking": {"type": "unrestricted"}
  },
  "metadata": {"team": "infra"},
  "scope": "organization",
  "archived_at": "2026-06-16T13:47:18+08:00",
  "created_at": "2026-06-16T12:45:34+08:00",
  "updated_at": "2026-06-16T13:47:18+08:00",
  "request_id": "xxx"
}

响应为 Environment 对象,archived_at 已填入归档时间。字段如下:

响应字段

字段

类型

说明

id

string

环境 ID

type

string

固定为 environment

name / description / scope / config / metadata

string / object

环境基础属性与完整运行时配置

archived_at

string

归档时间,ISO 8601;归档接口返回的对象中该字段一定非空

created_at / updated_at

string

创建/最近更新时间

request_id

string

本次请求的唯一标识