文档首页/ 云容器引擎 CCE/ API参考/ API/ 集群升级/ 获取集群升级路径 - GetClusterUpgradePaths
更新时间:2026-08-24 GMT+08:00
分享

获取集群升级路径 - GetClusterUpgradePaths

功能介绍

获取集群升级路径

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /api/v3/clusterupgradepaths

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式),默认为application/json,有其他取值时会在具体接口中专门说明。

约束限制:

GET方法不做校验

取值范围:

不涉及

默认取值:

不涉及

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

apiVersion

String

参数解释:

API版本

取值范围:

不涉及

kind

String

参数解释:

资源类型

取值范围:

不涉及

metadata

Metadata object

参数解释:

基本信息,为集合类的元素类型,包含一组由不同名称定义的属性

取值范围:

不涉及

upgradePaths

Array of UpgradePath objects

参数解释:

升级路径集合

取值范围:

不涉及

表3 Metadata

参数

参数类型

描述

uid

String

参数解释

唯一id标识

取值范围

不涉及

name

String

参数解释

资源名称

取值范围

不涉及

labels

Map<String,String>

参数解释

资源标签,key/value对格式,接口保留字段,填写不会生效

取值范围

不涉及

annotations

Map<String,String>

参数解释

资源注解,由key/value组成

取值范围

不涉及

updateTimestamp

String

参数解释

更新时间

取值范围

不涉及

creationTimestamp

String

参数解释

创建时间

取值范围

不涉及

表4 UpgradePath

参数

参数类型

描述

version

String

参数解释:

集群版本,v1.19及以下集群形如v1.19.16-r20,v1.21及以上形如v1.21,v1.23,详细请参考CCE集群版本号说明。

取值范围:

不涉及

platformVersion

String

参数解释:

CCE集群平台版本号,表示集群版本(version)下的内部版本。用于跟踪某一集群版本内的迭代,集群版本内唯一,跨集群版本重新计数。

platformVersion格式为:cce.X.Y

  • X: 表示内部特性版本。集群版本中特性或者补丁修复,或者OS支持等变更场景。其值从1开始单调递增。

  • Y: 表示内部特性版本的补丁版本。仅用于特性版本上线后的软件包更新,不涉及其他修改。其值从0开始单调递增。

取值范围:

不涉及

targetVersions

Array of strings

参数解释:

可升级的目标版本集合

取值范围:

不涉及

请求示例

响应示例

状态码:200

表示获取集群升级路径信息成功。

{
  "kind" : "ClusterUpgradePaths",
  "apiVersion" : "v3",
  "metadata" : { },
  "upgradePaths" : [ {
    "version" : "v1.25",
    "platformVersion" : "cce.5.0",
    "targetVersions" : [ "v1.25.6-r0", "v1.27.3-r0" ]
  }, {
    "version" : "v1.25",
    "platformVersion" : "cce.4.0",
    "targetVersions" : [ "v1.25.6-r0", "v1.27.3-r0" ]
  }, {
    "version" : "v1.23",
    "platformVersion" : "cce.10.0",
    "targetVersions" : [ "v1.23.11-r0", "v1.25.6-r0", "v1.27.3-r0" ]
  }, {
    "version" : "v1.23",
    "platformVersion" : "cce.9.0",
    "targetVersions" : [ "v1.23.11-r0", "v1.25.6-r0", "v1.27.3-r0" ]
  } ]
}

状态码

状态码

描述

200

表示获取集群升级路径信息成功。

错误码

请参见错误码

相关文档