文档首页/ 云容器引擎 CCE/ API参考（阿布扎比区域）/ API/ 模板管理/ 更新指定模板实例
更新时间：2025-05-16 GMT+08:00
查看PDF
分享

更新指定模板实例

功能介绍

更新指定模板实例

URI

PUT /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name}

表1 路径参数

参数

是否必选

参数类型

描述

name

是

String

模板实例名称

namespace

是

String

模板实例所在的命名空间

cluster_id

是

String

集群ID，获取方式请参见如何获取接口URI中参数。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式）

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见获取token。
表3 请求Body参数

参数

是否必选

参数类型

描述

chart_id

是

String

模板ID

action

是

String

更新操作，升级为upgrade，回退为rollback

parameters

是

ReleaseReqBodyParams object

模板实例参数

values

是

values object

模板实例的值
表4 ReleaseReqBodyParams

参数

是否必选

参数类型

描述

dry_run

否

Boolean

开启后，仅验证模板参数，不进行安装

name_template

否

String

实例名称模板

no_hooks

否

Boolean

安装时是否禁用hooks

replace

否

Boolean

是否替换同名实例

recreate

否

Boolean

是否重建实例

reset_values

否

Boolean

更新时是否重置values

release_version

否

Integer

回滚实例的版本

include_hooks

否

Boolean

更新或者删除时启用hooks
表5 values

参数

是否必选

参数类型

描述

imagePullPolicy

否

String

镜像拉取策略

imageTag

否

String

镜像标签

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

chart_name

String

模板名称

chart_public

Boolean

是否公开模板

chart_version

String

模板版本

cluster_id

String

集群ID

cluster_name

String

集群名称

create_at

String

创建时间

description

String

模板实例描述

name

String

模板实例名称

namespace

String

模板实例所在的命名空间

parameters

String

模板实例参数

resources

String

模板实例需要的资源

status

String

模板实例状态

  • DEPLOYED：已部署，表示模板实例处于正常状态。

  • DELETED：已删除，表示模板实例已经被删除。

  • FAILED：失败，表示模板实例部署失败。

  • DELETING：删除中，表示模板实例正处于删除过程中。

  • PENDING_INSTALL：待安装，表示模板正在等待安装。

  • PENDING_UPGRADE：待升级，表示模板正在等待升级。

  • PENDING_ROLLBACK：待回滚，表示模板正在等待回滚。

  • UNKNOWN：未知，表示模板状态异常，可尝试手动删除后重新安装。

status_description

String

模板实例状态描述

update_at

String

更新时间

values

String

模板实例的值

version

Integer

模板实例版本

请求示例

PUT /cce/cam/v3/clusters/{cluster_id}/namespace/{namespace}/releases/{name}

{
  "chart_id" : "af4b699e-018c-11ec-b8b0-0255ac100b05",
  "action" : "upgrade",
  "parameters" : {
    "dry_run" : false,
    "name_template" : "string",
    "no_hooks" : false,
    "replace" : false,
    "recreate" : false,
    "reset_values" : false,
    "release_version" : 1,
    "include_hooks" : false
  },
  "values" : {
    "imagePullPolicy" : "IfNotPresent",
    "imageTag" : "v2"
  }
}

响应示例

状态码： 200

OK

{
  "chart_name" : "magento-mysql",
  "chart_public" : false,
  "chart_version" : "1.0.0",
  "cluster_id" : "a870253f-5dc7-11ee-bf71-0255ac100b03",
  "cluster_name" : "sfs-turbo-test",
  "create_at" : "2023-11-14T20:30:57+08:00",
  "description" : "Initial install underway",
  "name" : "testwww",
  "namespace" : "monitoring",
  "parameters" : "",
  "resources" : "",
  "status" : "PENDING_INSTALL",
  "status_description" : "Initial install underway",
  "update_at" : "2023-11-14T20:30:57+08:00",
  "values" : "{\"basic\":{\"admin_password\":\"******\",\"admin_username\":\"username\",\"app_name\":\"magento\",\"mysql_database\":\"magento\",\"mysql_name\":\"mysql\",\"mysql_password\":\"******\",\"mysql_port\":3306,\"mysql_root_password\":\"******\",\"mysql_user\":\"magento\",\"storage_class\":\"csi-nas\",\"storage_mode\":\"ReadWriteMany\",\"storage_size\":\"10G\"},\"global\":{\"magento_EIP\":\"100.100.100.100\",\"magento_EPORT\":32080,\"namespace\":\"default\"},\"image\":{\"magento_image\":\"example.com/everest/magento:latest\",\"mysql_image\":\"example.com/everest/mysql:5.7.14\"}}",
  "version" : 1
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 模板管理