获取集群升级记录
功能介绍
通过此接口获取当前集群升级记录。
调用方法
请参见如何调用API。
URI
GET /v1/{project_id}/clusters/{cluster_id}/upgrade-management/records
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| cluster_id | 是 | String | 参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Integer | 参数解释: 分页偏移量,从0开始,页数减1。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 0 |
| limit | 否 | Integer | 参数解释: 分页单页大小。 约束限制: 不涉及。 取值范围: 大于0。 默认取值: 10 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 参数解释: 集群升级记录总数。 取值范围: 不涉及。 |
| records | Array of ClusterUpdateRecordResp objects | 参数解释: 集群升级记录列表。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| item_id | String | 参数解释: 升级项目ID。 取值范围: 不涉及。 |
| status | String | 参数解释: 升级状态。 取值范围: 不涉及。 |
| record_type | String | 参数解释: 升级类型。 取值范围: 不涉及。 |
| from_version | String | 参数解释: 升级前版本。 取值范围: 不涉及。 |
| to_version | 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/records 响应示例
状态码:200
查询成功。
{
"records" : [ {
"item_id" : "930d2820-fc17-4a42-9a50-eb695bf05e83",
"status" : "UpdateCompleted_Success",
"record_type" : "update-kernel",
"from_version" : "8.2.0",
"to_version" : "8.2.0.100",
"start_time" : "2023-08-04T06:46:46",
"end_time" : "2023-08-04T06:54:59",
"job_id" : "2c90804789bf441e0189bf4c78fd0001",
"failed_reason" : null
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功。 |
| 400 | 请求错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 500 | 服务内部错误。 |
| 503 | 服务不可用。 |