查询沙箱详情

使用列表或创建返回的实际 ID,读取工作区沙箱阶段、规格和网络设置。

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

调用前准备

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

请求

curl "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 为路径必填字符串,来自 data[].id 或创建结果 data.id。对象必须属于相同工作区且当前身份可见;显示名、edge_agent_id 和临时会话身份不能代替该 ID。

成功响应

{
  "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

当前沙箱,全部字段见公共对象。

结果确认

phase:ready 后再验证目标终端或作业。provisioning 表示仍在准备;unknown/error 需结合实际错误处理,不能因 GET 成功认定运行正常。update_available:null 为未知,不等于无更新。

错误处理

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

最后更新于