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

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

功能介绍

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

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

cluster_id

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

apiVersion

String

api版本,默认为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

kind

String

资源类型,默认为PreCheckTask

metadata

PrecheckTaskMetadata object

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

spec

PrecheckSpec object

升级前检查任务信息

status

PrecheckStatus object

升级前检查任务状态

表5 PrecheckTaskMetadata

参数

参数类型

描述

uid

String

任务ID

creationTimestamp

String

任务创建时间

updateTimestamp

String

任务更新时间

表6 PrecheckSpec

参数

参数类型

描述

clusterID

String

集群ID

clusterVersion

String

集群版本

targetVersion

String

升级目标版本

skippedCheckItemList

Array of skippedCheckItemList objects

跳过检查的项目列表

表7 skippedCheckItemList

参数

参数类型

描述

name

String

跳过的检查项名称

resourceSelector

resourceSelector object

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

表8 resourceSelector

参数

参数类型

描述

key

String

标签键值,取值如下

  • node.uid:节点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

状态

nodeType

String

节点类型

表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

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

错误码

请参见错误码