Template Management

Update Template

Update the configuration of a specific template

PUT

/api/v1/agentstudio/sandbox/templates/{templateCode}

cURL

curl --request PUT \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sandbox/templates/{templateCode}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "fromImage": "<string>",
  "imageName": "<string>",
  "mntConfig": [
    {
      "originFileName": "<string>",
      "originFileId": "<string>",
      "mountPath": "<string>"
    }
  ],
  "networkConfig": {
    "allowOut": [
      "<string>"
    ],
    "denyOut": [
      "<string>"
    ]
  },
  "envConfig": {},
  "autoPauseTime": 0,
  "maxRunningTimeout": 0,
  "description": "<string>"
}
'

{
  "templateID": "<string>",
  "templateName": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "buildID": "<string>",
  "buildStatus": "<string>",
  "version": 0,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

string

header

required

Path Parameters

string

required

模版唯一 code（即创建接口返回的 templateID）

Body

application/json

string

模版名称，未传时保留原名称

integer

vCPU 数量，必须与 memoryMB 同时传；未传时保留原规格

integer

内存大小，单位 MB，必须与 cpuCount 同时传；未传时保留原规格

string

基础镜像，未传时保留原镜像

string

镜像展示名称，未传时保留原展示名称

object[]

文件挂载配置，传入时重新校验文件 ID

Show child attributes

string

required

当前工作空间中真实存在的文件 ID

string

required

实例中的挂载路径

string

原始文件名

object

网络规则，与创建模版一致

Show child attributes

string[]

出口白名单，支持 IPv4、IPv6、CIDR 和域名

string[]

出口黑名单，仅支持 IPv4、IPv6 和 CIDR，不支持域名

object

替换为本次传入的环境变量键值对

integer

到期自动暂停时间，单位秒，取值范围 [300,604800]

Required range:300 <= x <= 604800

integer

最大运行时间，单位秒，取值范围 [300,604800]

Required range:300 <= x <= 604800

string

模版描述

Response

200-application/json

string

模版 ID，更新前后保持不变

string

模版名称

integer

vCPU 数量

integer

内存大小，单位 MB

string

新版本构建 ID，用于查询构建状态

string

构建状态，可能为 building

integer

模版版本号，每次成功更新后递增

string

模版首次创建时间

string

本次更新时间

cURL

curl --request PUT \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sandbox/templates/{templateCode}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "fromImage": "<string>",
  "imageName": "<string>",
  "mntConfig": [
    {
      "originFileName": "<string>",
      "originFileId": "<string>",
      "mountPath": "<string>"
    }
  ],
  "networkConfig": {
    "allowOut": [
      "<string>"
    ],
    "denyOut": [
      "<string>"
    ]
  },
  "envConfig": {},
  "autoPauseTime": 0,
  "maxRunningTimeout": 0,
  "description": "<string>"
}
'

{
  "templateID": "<string>",
  "templateName": "<string>",
  "cpuCount": 0,
  "memoryMB": 0,
  "buildID": "<string>",
  "buildStatus": "<string>",
  "version": 0,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}