文档首页/ 云容器引擎 CCE/ API参考/ API/ 集群升级/ 获取集群升级前检查任务详情列表 - GetPreCheckList
更新时间:2026-08-24 GMT+08:00
分享

获取集群升级前检查任务详情列表 - GetPreCheckList

功能介绍

获取集群升级前检查任务详情列表

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方式请参见如何获取接口URI中参数

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

String

参数解释:

集群ID,获取方式请参见如何获取接口URI中参数

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

apiVersion

String

参数解释:

API版本,默认为v3

取值范围:

  • v3

kind

String

参数解释:

类型

取值范围:

不涉及

metadata

Metadata object

参数解释:

基本信息,为集合类的元素类型,包含一组由不同名称定义的属性

取值范围:

不涉及

items

Array of PrecheckClusterTask objects

参数解释:

集群检查任务列表

取值范围:

不涉及

表3 Metadata

参数

参数类型

描述

uid

String

参数解释

唯一id标识

取值范围

不涉及

name

String

参数解释

资源名称

取值范围

不涉及

labels

Map<String,String>

参数解释

资源标签,key/value对格式,接口保留字段,填写不会生效

取值范围

不涉及

annotations

Map<String,String>

参数解释

资源注解,由key/value组成

取值范围

不涉及

updateTimestamp

String

参数解释

更新时间

取值范围

不涉及

creationTimestamp

String

参数解释

创建时间

取值范围

不涉及

表4 PrecheckClusterTask

参数

参数类型

描述

apiVersion

String

参数解释:

API版本,默认为v3

取值范围:

  • v3

kind

String

参数解释:

资源类型,默认为PreCheckTask

取值范围:

  • PreCheckTask

metadata

PrecheckTaskMetadata object

参数解释:

升级前检查任务元数据信息

取值范围:

不涉及

spec

PrecheckCluserResponseSpec object

参数解释:

升级前检查任务信息

取值范围:

不涉及

status

PrecheckStatus object

参数解释:

升级前检查任务状态

取值范围:

不涉及

表5 PrecheckTaskMetadata

参数

参数类型

描述

uid

String

参数解释:

任务ID

取值范围:

不涉及

creationTimestamp

String

参数解释:

任务创建时间

取值范围:

不涉及

updateTimestamp

String

参数解释:

任务更新时间

取值范围:

不涉及

表6 PrecheckCluserResponseSpec

参数

参数类型

描述

clusterID

String

参数解释:

集群ID

取值范围:

不涉及

clusterVersion

String

参数解释:

当前集群版本

取值范围:

不涉及

targetVersion

String

参数解释:

升级目标版本

取值范围:

不涉及

skippedCheckItemList

Array of skippedCheckItemListResponse objects

参数解释:

跳过检查的项目列表

取值范围:

不涉及

表7 skippedCheckItemListResponse

参数

参数类型

描述

name

String

参数解释:

跳过检查的项目名称

取值范围:

不涉及

resourceSelector

resourceSelectorResponse object

参数解释:

资源标签选择器,仅节点检查涉及该参数,集群检查和插件检查不涉及

取值范围:

不涉及

表8 resourceSelectorResponse

参数

参数类型

描述

key

String

参数解释:

标签键值

取值范围:

  • node.uid

values

Array of strings

参数解释:

标签值列表

取值范围:

不涉及

operator

String

参数解释:

标签逻辑运算符

取值范围:

  • In

表9 PrecheckStatus

参数

参数类型

描述

phase

String

参数解释:

状态

取值范围:

  • Init:初始化

  • Running:运行中

  • Success:成功

  • Failed:失败

  • Error:错误

expireTimeStamp

String

参数解释:

检查结果过期时间

取值范围:

不涉及

message

String

参数解释:

信息,一般是执行错误的日志信息

取值范围:

不涉及

clusterCheckStatus

clusterCheckStatus object

参数解释:

集群限制检查状态

取值范围:

不涉及

addonCheckStatus

addonCheckStatus object

参数解释:

插件检查状态

取值范围:

不涉及

nodeCheckStatus

nodeCheckStatus object

参数解释:

节点检查状态

取值范围:

不涉及

表10 clusterCheckStatus

参数

参数类型

描述

phase

String

参数解释:

状态

取值范围:

  • Init:初始化

  • Running:运行中

  • Success:成功

  • Failed:失败

itemsStatus

Array of PreCheckItemStatus objects

参数解释:

检查项状态集合

取值范围:

不涉及

表11 addonCheckStatus

参数

参数类型

描述

phase

String

参数解释:

状态

取值范围:

  • Init:初始化

  • Running:运行中

  • Success:成功

  • Failed:失败

itemsStatus

Array of PreCheckItemStatus objects

参数解释:

检查项状态集合

取值范围:

不涉及

表12 nodeCheckStatus

参数

参数类型

描述

phase

String

参数解释:

状态

取值范围:

  • Init:初始化

  • Running:运行中

  • Success:成功

  • Failed:失败

nodeStageStatus

Array of NodeStageStatus objects

参数解释:

节点检查状态

取值范围:

不涉及

表13 NodeStageStatus

参数

参数类型

描述

nodeInfo

NodeInfo object

参数解释:

节点信息。

取值范围:

不涉及

itemsStatus

Array of PreCheckItemStatus objects

参数解释:

检查项状态集合。

取值范围:

不涉及

表14 NodeInfo

参数

参数类型

描述

uid

String

参数解释:

节点UID。

取值范围:

不涉及

name

String

参数解释:

节点名称。

取值范围:

不涉及

status

String

参数解释

节点状态

取值范围

节点资源生命周期管理(如安装卸载等)状态和集群内K8s node状态的综合体现,取值如下

  • Build:创建中,表示节点正处于创建过程中。

  • Installing:安装中,表示节点正处于纳管过程中。

  • Upgrading:升级中,表示节点正处于升级过程中。

  • Active:运行中,表示节点处于正常状态。

  • Abnormal:不可用,表示节点处于异常状态。

  • Deleting: 删除中,表示节点正处于删除过程中。

  • Error:错误,表示节点处于故障状态。

nodeType

String

参数解释

节点类型

取值范围

  • BareMetal:裸金属服务器

  • VirtualMachine:弹性云服务器

表15 PreCheckItemStatus

参数

参数类型

描述

name

String

参数解释:

检查项名称

取值范围:

不涉及

kind

String

参数解释:

检查项类型

取值范围:

  • Exception:异常类,需要用户解决

  • Risk:风险类,用户确认后可选择跳过

group

String

参数解释:

检查项分组

取值范围:

  • LimitCheck:集群限制检查

  • MasterCheck:控制节点检查

  • NodeCheck:用户节点检查

  • AddonCheck:插件检查

  • ExecuteException:检查流程错误

level

String

参数解释:

检查项风险级别

取值范围:

  • Info:提示级别

  • Warning:风险级别

  • Fatal:严重级别

phase

String

参数解释:

状态

取值范围:

  • Init:初始化

  • Running:运行中

  • Success:成功

  • Failed:失败

message

String

参数解释:

提示信息

取值范围:

不涉及

riskSource

riskSource object

参数解释:

风险项来源。

取值范围:

不涉及

errorCodes

Array of strings

参数解释:

错误码集合

取值范围:

不涉及

表16 riskSource

参数

参数类型

描述

configurationRisks

Array of configurationRisks objects

参数解释:

配置风险项。

取值范围:

不涉及

deprecatedAPIRisks

Array of deprecatedAPIRisks objects

参数解释:

废弃API风险。

取值范围:

不涉及

nodeRisks

Array of nodeRisks objects

参数解释:

节点风险。

取值范围:

不涉及

addonRisks

Array of addonRisks objects

参数解释:

插件风险。

取值范围:

不涉及

表17 configurationRisks

参数

参数类型

描述

package

String

参数解释:

组件名称。

取值范围:

不涉及

sourceFile

String

参数解释:

涉及文件路径。

取值范围:

不涉及

nodeMsg

String

参数解释:

节点信息。

取值范围:

不涉及

field

String

参数解释:

参数值。

取值范围:

不涉及

operation

String

参数解释:

修改操作类型。

取值范围:

不涉及

originalValue

String

参数解释:

原始值。

取值范围:

不涉及

value

String

参数解释:

当前值。

取值范围:

不涉及

表18 deprecatedAPIRisks

参数

参数类型

描述

url

String

参数解释:

请求路径,如/apis/policy/v1beta1/podsecuritypolicies。

取值范围:

不涉及

userAgent

String

参数解释:

客户端信息。

取值范围:

不涉及

表19 nodeRisks

参数

参数类型

描述

NodeID

String

参数解释:

用户节点ID。

取值范围:

不涉及

表20 addonRisks

参数

参数类型

描述

addonTemplateName

String

参数解释:

插件模板名称。

取值范围:

不涉及

alias

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

表示获取集群升级前检查任务详情列表成功。

错误码

请参见错误码

相关文档