获取实例

获取指定实例的详细信息，包含资源规格、数据面访问信息、网络与生命周期配置。兼容 E2B 获取实例协议，对应 SDK 的 get_info()。

前提

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

接口

GET /sandboxes/{sandboxID}

获取指定实例的详细信息。兼容 E2B 获取实例协议，对应 SDK 的 get_info()。实例不存在时返回 404，错误文案为「沙箱实例不存在」。无网络或生命周期配置时，对应字段省略或返回空对象。

路径参数

请求示例

curl -X GET "$BASE_URL/sandboxes/sbx-xxx" \
  -H "Authorization: Bearer $BAILIAN_API_KEY"

其中 BASE_URL 为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sandbox，BAILIAN_API_KEY 为阿里云百炼 API Key。

响应示例

{
  "sandboxID": "sbx-xxx",
  "bailianSandboxId": "your-bailian-sandbox-id",
  "templateID": "your-template-id",
  "state": "running",
  "cpuCount": 1,
  "memoryMB": 2048,
  "envdVersion": "your-envd-version",
  "domain": "your-sandbox-domain",
  "envdAccessToken": "your-envd-access-token",
  "trafficAccessToken": "your-traffic-access-token",
  "envdUrl": "your-envd-url",
  "allowInternetAccess": true,
  "network": {
    "allowPublicTraffic": true,
    "allowOut": ["example.com"],
    "denyOut": ["10.0.0.0/8"]
  },
  "lifecycle": {
    "onTimeout": "pause",
    "autoResume": true
  }
}

响应字段