查询工作区沙箱

读取当前身份可见的工作区托管沙箱,保存返回 ID 以继续查询详情。

GET https://api.moi.matrixorigin.cn/v5/agent-sandboxes

调用前准备

准备目标工作区的个人访问令牌与相应操作权限;环境、令牌、工作区和沙箱 ID 保持一致。公共对象和结果确认说明资源身份、字段及状态。示例的资源值须替换为实际值。

请求

curl "https://api.moi.matrixorigin.cn/v5/agent-sandboxes" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

本接口没有公开的 page、offset 或筛选参数。返回数组按当前权限过滤,排除正在删除和尚未完成创建登记的对象;空数组不证明工作区全局没有沙箱。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": [
    {
      "id": "sbx-example",
      "workspace_id": "workspace-example",
      "user_id": "user-example",
      "name": "audit-runner",
      "phase": "ready",
      "edge_agent_id": "sbx-example",
      "network_mode": "limited",
      "network_tools": [
        "git",
        "curl"
      ],
      "egress_endpoints": [
        {
          "host": "example.com",
          "ports": [
            443
          ]
        }
      ],
      "spec": "medium",
      "disk_gi": 10,
      "created_at": "2026-11-11T08:00:00Z",
      "updated_at": "2026-11-11T08:00:00Z",
      "update_available": null
    }
  ]
}

HTTP 200 的数据含义如下;示例值不是默认配置。

字段

类型

说明

code

string

成功时为 OK。

msg

string

响应说明。

data

object(对象数组)

可见托管沙箱;字段见公共对象。

结果确认

从 data[].id 读取实际 ID,再查询详情。会话运行期临时沙箱不属于本列表。

错误处理

按 HTTP 状态及响应 code 判断;公共错误与恢复区分参数、权限、配额、提供商和结果未知。错误不证明尚未产生资源,也不能当成重试或清理已经完成。

最后更新于