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

获取集群升级记录

功能介绍

通过此接口获取当前集群升级记录。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/clusters/{cluster_id}/upgrade-management/records

表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

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

count

Integer

参数解释

集群升级记录总数。

取值范围

不涉及。

records

Array of ClusterUpdateRecordResp objects

参数解释

集群升级记录列表。

取值范围

不涉及。

表4 ClusterUpdateRecordResp

参数

参数类型

描述

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

服务不可用。