获取集群升级路径 - GetClusterUpgradePaths
功能介绍
获取集群升级路径
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /api/v3/clusterupgradepaths
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 参数解释: 消息体的类型(格式) 约束限制: GET方法不做校验 取值范围:
默认取值: 不涉及 |
X-Auth-Token | 是 | String | 参数解释: 调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
apiVersion | String | API版本 |
kind | String | 资源类型 |
metadata | Metadata object | 基本信息,为集合类的元素类型,包含一组由不同名称定义的属性 |
upgradePaths | Array of UpgradePath objects | 升级路径集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
uid | String | 参数解释: 唯一id标识 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
name | String | 参数解释: 资源名称 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
labels | Map<String,String> | 参数解释: 资源标签,key/value对格式,接口保留字段,填写不会生效 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
annotations | Map<String,String> | 参数解释: 资源注解,由key/value组成 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
updateTimestamp | String | 参数解释: 更新时间 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
creationTimestamp | String | 参数解释: 创建时间 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 表示获取集群升级路径信息成功。 |
错误码
请参见错误码。

