集群升级后确认 - 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
kind	是	String	参数解释： API类型约束限制：固定值取值范围： 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"
  }
}