文档首页/ 云容器引擎 CCE/ API参考/ API/ 集群升级/ 集群升级后确认 - PostCheck
更新时间:2026-08-24 GMT+08:00
分享

集群升级后确认 - PostCheck

功能介绍

集群升级后确认,该接口建议配合Console使用,主要用于升级步骤完成后,客户确认集群状态和业务正常后做反馈。

调用方法

请参见如何调用API

授权信息

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

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

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/postcheck

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

apiVersion

String

参数解释:

API版本,固定值"v3",该值不可修改。

约束限制:

该值不可修改

取值范围:

  • v3

默认取值:

v3

kind

String

参数解释:

API类型,固定值"PostCheckTask",该值不可修改。

约束限制:

该值不可修改

取值范围:

  • PostCheckTask

默认取值:

PostCheckTask

spec

PostcheckResponseSpec object

参数解释:

spec是升级后确认的配置信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 PostcheckResponseSpec

参数

是否必选

参数类型

描述

clusterID

String

参数解释:

集群ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

clusterVersion

String

参数解释:

升级前的集群版本

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

targetVersion

String

参数解释:

当前集群版本

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

apiVersion

String

参数解释:

API版本

取值范围:

不涉及

kind

String

参数解释:

资源类型

取值范围:

不涉及

metadata

PostcheckCluserResponseMetadata object

参数解释:

升级后确认元数据

取值范围:

不涉及

spec

PostcheckSpec object

参数解释:

集群升级后确认的配置信息

取值范围:

不涉及

status

status object

参数解释:

集群升级后确认的状态信息

取值范围:

不涉及

表5 PostcheckCluserResponseMetadata

参数

参数类型

描述

uid

String

参数解释:

任务ID

取值范围:

不涉及

表6 PostcheckSpec

参数

参数类型

描述

clusterID

String

参数解释:

集群ID

取值范围:

不涉及

clusterVersion

String

参数解释:

升级前的集群版本

取值范围:

不涉及

targetVersion

String

参数解释:

当前集群版本

取值范围:

CCE支持的集群版本

表7 status

参数

参数类型

描述

phase

String

参数解释:

状态

取值范围:

  • Success:成功

  • Failed:失败

  • Error:错误

请求示例

集群升级后确认

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/postcheck

{
  "kind" : "PostCheckTask",
  "apiVersion" : "v3",
  "spec" : {
    "clusterID" : "8978deaa-1743-11ee-8e46-0255ac10004c",
    "clusterVersion" : "v1.15.11-r1",
    "targetVersion" : "v1.19.16-r80"
  }
}

响应示例

状态码:200

集群升级后确认成功。

{
  "kind" : "PostCheckTask",
  "apiVersion" : "v3",
  "metadata" : {
    "uid" : "e99fedf8-348c-4084-b0fd-81bf187df4e0"
  },
  "spec" : {
    "clusterID" : "8978deaa-1743-11ee-8e46-0255ac10004c",
    "clusterVersion" : "v1.15.11-r1",
    "targetVersion" : "v1.19.16-r80"
  },
  "status" : {
    "phase" : "Success"
  }
}

状态码

状态码

描述

200

集群升级后确认成功。

错误码

请参见错误码

相关文档