删除 Agent 配置;已有 Session 使用创建时的快照,不受影响。
接口
DELETE /agents/{agent_id}
成功返回 200 和删除信封。删除为软归档:Agent 标记为已删除并记录删除时间,之后获取或再次删除返回 404。
删除只归档 Agent,不停止已有 Session,也不清理环境。已有 Session 使用创建时的 Agent 快照,不受后续删除影响。
路径参数agent_idstring (必选)Agent ID,按不透明字符串使用本接口没有请求体和 Query 参数。 | 请求示例 |
响应字段idstring被删除的 Agent IDobject stringAgent 删除结果对象类型,固定为 agent.deleteddeleted boolean是否删除成功,删除成功时为 true | 响应示例 |
错误码
业务错误返回 error 对象,包含 type、code、message 和 param。常见错误如下:
| HTTP 状态码 | 错误类型 / 错误码 | 解决方案 |
|---|---|---|
401 | authentication_error / invalid_api_key | 在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY |
404 | not_found_error / not_found_error | 使用当前工作空间中存在且未删除的 Agent ID |
500 | server_error / server_error | 稍后重试;持续失败时提交工单并提供 x-request-id |