删除工作区沙箱¶
删除已确认的工作区托管沙箱并清理相应运行资源;操作会中断使用该沙箱的会话。
DELETE https://api.moi.matrixorigin.cn/v5/agent-sandboxes/{sandbox_id}
调用前准备¶
准备目标工作区的个人访问令牌与相应操作权限;环境、令牌、工作区和沙箱 ID 保持一致。公共对象和结果确认说明资源身份、字段及状态。示例的资源值须替换为实际值。
请求¶
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/agent-sandboxes/$SANDBOX_ID" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
sandbox_id 是路径必填字符串;无请求体。删除有不可恢复的运行资源副作用,先确认 ID、工作区和资源归属。
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {}
}
HTTP 200 的数据含义如下;示例值不是默认配置。
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功时为 OK。 |
|
string |
响应说明。 |
|
object |
成功时为空对象。 |
结果确认¶
返回 200 表示删除链已正常返回;后续详情可为 404。单独看到 404 或列表变空不足以证明全部外部清理已完成,因为删除中的对象本就被查询隐藏。失败时保留原 ID 和请求记录,不删除其他同名对象代替清理。
错误处理¶
按 HTTP 状态及响应 code 判断;公共错误与恢复区分参数、权限、配额、提供商和结果未知。错误不证明尚未产生资源,也不能当成重试或清理已经完成。
最后更新于