Instance Management

List Instances

List sandbox instances in the current workspace

GET

/api/v1/agentstudio/sandbox/v2/sandboxes

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sandbox/v2/sandboxes' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

[
  {
    "clientID": "<string>",
    "sandboxID": "<string>",
    "bailianSandboxId": "<string>",
    "templateID": "<string>",
    "alias": "<string>",
    "state": "<string>",
    "cpuCount": 0,
    "memoryMB": 0,
    "diskSizeMB": 0,
    "envdVersion": "<string>",
    "startedAt": "<string>",
    "endAt": "<string>",
    "metadata": {}
  }
]

Authorizations

string

header

required

Query Parameters

string

按模版 ID 过滤。兼容 templateId、template

string

按实例 ID 精确过滤

string

按状态过滤，例如 running、paused

integer

default20

单页条数，默认 20，最大 50

Required range:x <= 50

Response

200-application/json

string

客户端标识

string

实例唯一 ID

string

百炼扩展标识；开发者通常无需使用

string

模版 ID

string

模版别名

string

实例状态，例如 running

integer

vCPU 核数

integer

内存大小，单位 MB

integer

磁盘大小，单位 MB

string

envd 版本

string

实例启动时间

string

实例到期时间

object

自定义元数据

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sandbox/v2/sandboxes' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

[
  {
    "clientID": "<string>",
    "sandboxID": "<string>",
    "bailianSandboxId": "<string>",
    "templateID": "<string>",
    "alias": "<string>",
    "state": "<string>",
    "cpuCount": 0,
    "memoryMB": 0,
    "diskSizeMB": 0,
    "envdVersion": "<string>",
    "startedAt": "<string>",
    "endAt": "<string>",
    "metadata": {}
  }
]