更新时间:2025-09-18 GMT+08:00

获取集群可升级的目标版本

功能介绍

获取集群可升级的目标版本。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/clusters/{cluster_id}/upgrade-management/avail-versions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

必须是有效的dws集群ID。

取值范围

36位UUID。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释

分页偏移量,从0开始,页数减1。

约束限制

不涉及。

取值范围

大于等于0。

默认取值

0

limit

Integer

参数解释

分页单页大小。

约束限制

不涉及。

取值范围

大于0。

默认取值

10

type

String

参数解释

升级类型。

约束限制

不涉及。

取值范围

cluster:集群升级。

hotpatch:热补丁升级。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

count

Integer

参数解释

集群升级路径总条数。

取值范围

不涉及。

items

Array of UpdateItemResp objects

参数解释

集群升级路径列表。

取值范围

不涉及。

表4 UpdateItemResp

参数

参数类型

描述

id

String

参数解释

升级项ID。

取值范围

不涉及。

from

String

参数解释

起始版本。

取值范围

不涉及。

to

String

参数解释

目标版本。

取值范围

不涉及。

status

String

参数解释

升级路径状态。

取值范围

不涉及。

process

String

参数解释

升级进度。

取值范围

不涉及。

start_time

String

参数解释

起始时间。

取值范围

不涉及。

end_time

String

参数解释

结束时间。

取值范围

不涉及。

job_id

String

参数解释

升级任务ID。

取值范围

不涉及。

failed_reason

String

参数解释

失败原因。

取值范围

不涉及。

请求示例

GET https://{Endpoint}/v1/0536cdee2200d5912f7cc00b877980f1/clusters/c719b1a7-c85c-4cb5-a721-7694908c2c11/upgrade-management/avail-versions?type=cluster

响应示例

状态码:200

查询成功。

{
  "items" : [ {
    "id" : "930d2820-fc17-4a42-9a50-eb695bf05e83",
    "from" : "8.2.0",
    "to" : "8.2.0.100",
    "status" : "Update_Success",
    "process" : "0",
    "start_time" : "2023-08-04T06:54:52",
    "end_time" : "",
    "job_id" : "2c90804789bf441e0189bf4c78fd0001",
    "failed_reason" : null
  } ]
}

状态码

状态码

描述

200

查询成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

500

服务内部错误。

503

服务不可用。