获取集群升级前检查任务详情列表 - GetPreCheckList
功能介绍
获取集群升级前检查任务详情列表
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 项目ID，获取方式请参见如何获取接口URI中参数。 约束限制： 不涉及 取值范围： 账号的项目ID 默认取值： 不涉及 |
cluster_id | 是 | String | 参数解释： 集群ID，获取方式请参见如何获取接口URI中参数。 约束限制： 不涉及 取值范围： 集群ID 默认取值： 不涉及 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
apiVersion | String | api版本，默认为v3 |
kind | String | 类型 |
metadata | Metadata object | 基本信息，为集合类的元素类型，包含一组由不同名称定义的属性 |
items | Array of PrecheckClusterTask objects | 集群检查任务列表 |
参数 | 参数类型 | 描述 |
|---|---|---|
uid | String | 参数解释： 唯一id标识 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
name | String | 参数解释： 资源名称 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
labels | Map<String,String> | 参数解释： 资源标签，key/value对格式，接口保留字段，填写不会生效 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
annotations | Map<String,String> | 参数解释： 资源注解，由key/value组成 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
updateTimestamp | String | 参数解释： 更新时间 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
creationTimestamp | String | 参数解释： 创建时间 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
apiVersion | String | api版本，默认为v3 |
kind | String | 资源类型，默认为PreCheckTask |
metadata | PrecheckTaskMetadata object | 升级前检查任务元数据信息 |
spec | PrecheckCluserResponseSpec object | 升级前检查任务信息 |
status | PrecheckStatus object | 升级前检查任务状态 |
参数 | 参数类型 | 描述 |
|---|---|---|
uid | String | 任务ID |
creationTimestamp | String | 任务创建时间 |
updateTimestamp | String | 任务更新时间 |
参数 | 参数类型 | 描述 |
|---|---|---|
clusterID | String | 集群ID |
clusterVersion | String | 当前集群版本 |
targetVersion | String | 升级目标版本 |
skippedCheckItemList | Array of skippedCheckItemListResponse objects | 跳过检查的项目列表 |
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 跳过检查的项目名称 |
resourceSelector | resourceSelectorResponse object | 资源标签选择器，仅节点检查涉及该参数，集群检查和插件检查不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
phase | String | 状态，取值如下
|
expireTimeStamp | String | 检查结果过期时间 |
message | String | 信息，一般是执行错误的日志信息 |
clusterCheckStatus | clusterCheckStatus object | 集群限制检查状态 |
addonCheckStatus | addonCheckStatus object | 插件检查状态 |
nodeCheckStatus | nodeCheckStatus object | 节点检查状态 |
参数 | 参数类型 | 描述 |
|---|---|---|
phase | String | 状态，取值如下
|
itemsStatus | Array of PreCheckItemStatus objects | 检查项状态集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
phase | String | 状态，取值如下
|
itemsStatus | Array of PreCheckItemStatus objects | 检查项状态集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
phase | String | 状态，取值如下
|
nodeStageStatus | Array of NodeStageStatus objects | 节点检查状态 |
参数 | 参数类型 | 描述 |
|---|---|---|
nodeInfo | NodeInfo object | 节点信息 |
itemsStatus | Array of PreCheckItemStatus objects | 检查项状态集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 检查项名称 |
kind | String | 检查项类型，取值如下
|
group | String | 检查项分组，取值如下
|
level | String | 检查项风险级别，取值如下
|
phase | String | 状态，取值如下
|
message | String | 提示信息 |
riskSource | riskSource object | 风险项 |
errorCodes | Array of strings | 错误码集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
configurationRisks | Array of configurationRisks objects | 配置风险项 |
deprecatedAPIRisks | Array of deprecatedAPIRisks objects | 废弃API风险 |
nodeRisks | Array of nodeRisks objects | 节点风险 |
addonRisks | Array of addonRisks objects | 插件风险 |
参数 | 参数类型 | 描述 |
|---|---|---|
package | String | 组件名称 |
sourceFile | String | 涉及文件路径 |
nodeMsg | String | 节点信息 |
field | String | 参数值 |
operation | String | 修改操作类型 |
originalValue | String | 原始值 |
value | String | 当前值 |
请求示例
无
响应示例
状态码：200
表示获取集群升级前检查任务详情列表成功。
{
"kind" : "List",
"apiVersion" : "v3",
"metadata" : { },
"items" : [ {
"kind" : "PreCheckTask",
"apiVersion" : "v3",
"metadata" : {
"uid" : "10b52d23-080a-4b7d-bf83-64b4687ca786",
"creationTimestamp" : "2023-12-16 07:07:11.099111 +0000 UTC",
"updateTimestamp" : "2023-12-16 07:09:10.425622 +0000 UTC"
},
"spec" : {
"clusterVersion" : "v1.23.5-r0",
"targetVersion" : "v1.23.11-r0"
},
"status" : {
"phase" : "Failed",
"clusterCheckStatus" : {
"phase" : "Success",
"itemsStatus" : [ {
"name" : "DeprecatedApiCheck",
"kind" : "Risk",
"group" : "LimitCheck",
"level" : "Info",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
}, {
"name" : "BlackLimit",
"kind" : "Exception",
"group" : "LimitCheck",
"level" : "Fatal",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
}, {
"name" : "MasterSSH",
"kind" : "Exception",
"group" : "LimitCheck",
"level" : "Fatal",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
}, {
"name" : "ReleaseLimit",
"kind" : "Exception",
"group" : "LimitCheck",
"level" : "Warning",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
}, {
"name" : "ClusterNoArm",
"kind" : "Exception",
"group" : "LimitCheck",
"level" : "Warning",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
} ]
},
"addonCheckStatus" : {
"phase" : "Failed",
"itemsStatus" : [ {
"name" : "AddonLimit",
"kind" : "Exception",
"group" : "AddonCheck",
"level" : "Warning",
"phase" : "Failed",
"message" : "addon [ CoreDNS,CCE Container Storage (Everest) ] status is abnormal, check and try again",
"riskSource" : {
"addonRisks" : [ {
"addonTemplateName" : "coredns",
"alias" : "CoreDNS"
}, {
"addonTemplateName" : "everest",
"alias" : "CCE Container Storage (Everest)"
} ]
}
}, {
"name" : "CoreDNSConfLimit",
"kind" : "Exception",
"group" : "AddonCheck",
"level" : "Fatal",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
}, {
"name" : "EverestLimitHungVersion",
"kind" : "Risk",
"group" : "AddonCheck",
"level" : "Fatal",
"phase" : "Success",
"message" : "check item succeed",
"riskSource" : { }
} ]
},
"nodeCheckStatus" : {
"phase" : "Success"
}
}
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 表示获取集群升级前检查任务详情列表成功。 |
错误码
请参见错误码。
