获取集群可升级的目标版本
功能介绍
获取集群可升级的目标版本。
调用方法
请参见如何调用API。
URI
GET /v1/{project_id}/clusters/{cluster_id}/upgrade-management/avail-versions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
cluster_id |
是 |
String |
参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
参数解释: 分页偏移量,从0开始,页数减1。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 0 |
limit |
否 |
Integer |
参数解释: 分页单页大小。 约束限制: 不涉及。 取值范围: 大于0。 默认取值: 10 |
type |
否 |
String |
参数解释: 升级类型。 约束限制: 不涉及。 取值范围: cluster:集群升级。 hotpatch:热补丁升级。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
参数解释: 集群升级路径总条数。 取值范围: 不涉及。 |
items |
Array of UpdateItemResp objects |
参数解释: 集群升级路径列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
服务不可用。 |