Skip to main content
模版管理

列举模版

列举当前工作空间下的沙箱模版,支持按游标分页。

前提

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

接口

GET /v2/templates 列举当前工作空间下的模版。兼容路由 GET /templates。

查询参数

参数必填类型说明
limit否integer单页条数,默认 100,最大 100
cursor否string分页位置标识

请求示例

curl -X GET "$BASE_URL/v2/templates?limit=100" \
  -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。

响应示例

响应体直接返回模版数组,不封装为分页对象。
[
  {
    "templateID": "your-template-id",
    "templateName": "my-template",
    "cpuCount": 1,
    "memoryMB": 2048,
    "public": false,
    "aliases": [],
    "names": ["my-template"],
    "createdAt": "2026-01-01T00:00:00Z",
    "updatedAt": "2026-01-01T00:00:00Z",
    "spawnCount": 2,
    "buildCount": 1,
    "envdVersion": "your-envd-version"
  }
]

响应字段

数组元素字段如下。
字段类型说明
templateIDstring模版 ID
templateNamestring模版名称
cpuCountintegervCPU 数量
memoryMBinteger内存大小,单位 MB
publicboolean是否公开
aliasesarray<string>别名列表
namesarray<string>模版名称列表
createdAtstring创建时间,date-time 格式
updatedAtstring更新时间,date-time 格式
spawnCountinteger当前模版实例数量
buildCountinteger模版版本数量
envdVersionstringenvd 版本
Managed Agents
Security
RAG
应用调用
长期记忆
ParseX
框架