获取集群可升级的目标版本
功能介绍
获取集群可升级的目标版本。
调用方法
请参见如何调用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 | 服务不可用。 |