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