Skip to main content
实例管理

获取实例

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

前提

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

接口

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

路径参数

参数必填类型说明
sandboxID是string实例唯一 ID

请求示例

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
  }
}

响应字段

字段类型说明
sandboxIDstring实例唯一 ID
bailianSandboxIdstring阿里云百炼扩展标识;开发者通常无需使用
templateIDstring模版 ID
statestring实例状态,例如 running
cpuCountintegervCPU 核数
memoryMBinteger内存大小,单位 MB
envdVersionstringenvd 版本
domainstring数据面访问域名
envdAccessTokenstringenvd 访问 token
trafficAccessTokenstring流量访问 token
envdUrlstringenvd 访问地址
allowInternetAccessboolean是否允许实例访问公网
networkobject实例级网络配置。子字段 allowPublicTraffic(boolean,是否允许公网流量)、allowOut(array<string>,出口白名单)、denyOut(array<string>,出口黑名单)。无网络配置时省略或返回空对象
lifecycleobject生命周期配置。子字段 onTimeout(string,到期行为,例如 pause)、autoResume(boolean,暂停后连接是否自动恢复)。无生命周期配置时省略或返回空对象
Managed Agents
Security
RAG
应用调用
长期记忆
ParseX
框架