Instance Management

Get Instance

Get details of a specific instance

GET

/api/v1/agentstudio/sandbox/sandboxes/{sandboxID}

cURL

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

{
  "sandboxID": "<string>",
  "bailianSandboxId": "<string>",
  "templateID": "<string>",
  "state": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "envdVersion": "<string>",
  "domain": "<string>",
  "envdAccessToken": "<string>",
  "trafficAccessToken": "<string>",
  "envdUrl": "<string>",
  "allowInternetAccess": false,
  "network": {
    "allowPublicTraffic": false,
    "allowOut": [
      "<string>"
    ],
    "denyOut": [
      "<string>"
    ]
  },
  "lifecycle": {
    "onTimeout": "<string>",
    "autoResume": false
  }
}

Authorizations

string

header

required

Path Parameters

string

required

实例唯一 ID

Response

200-application/json

string

实例唯一 ID

string

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

string

模版 ID

string

实例状态，例如 running

integer

vCPU 核数

integer

内存大小，单位 MB

string

envd 版本

string

数据面访问域名

string

envd 访问 token

string | null

流量访问 token

string

envd 访问地址

boolean

是否允许实例访问公网

object

实例级网络配置。无网络配置时省略或返回空对象

Show child attributes

boolean

是否允许公网流量

string[]

出口白名单

string[]

出口黑名单

object

生命周期配置。无生命周期配置时省略或返回空对象

Show child attributes

string

到期行为，例如 pause

boolean

暂停后连接是否自动恢复

cURL

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

{
  "sandboxID": "<string>",
  "bailianSandboxId": "<string>",
  "templateID": "<string>",
  "state": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "envdVersion": "<string>",
  "domain": "<string>",
  "envdAccessToken": "<string>",
  "trafficAccessToken": "<string>",
  "envdUrl": "<string>",
  "allowInternetAccess": false,
  "network": {
    "allowPublicTraffic": false,
    "allowOut": [
      "<string>"
    ],
    "denyOut": [
      "<string>"
    ]
  },
  "lifecycle": {
    "onTimeout": "<string>",
    "autoResume": false
  }
}