更新时间:2024-12-17 GMT+08:00
分享

获取集群升级路径

功能介绍

获取集群升级路径

调用方法

请参见如何调用API

URI

GET /api/v3/clusterupgradepaths

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式)

约束限制:

GET方法不做校验

取值范围:

  • application/json

  • application/json;charset=utf-8

  • application/x-pem-file

  • multipart/form-data(注:存在FormData参数时使用)

默认取值:

不涉及

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

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

错误码

请参见错误码

相关文档