# 集群升级后确认 - PostCheck
#### 功能介绍
集群升级后确认，该接口建议配合Console使用，主要用于升级步骤完成后，客户确认集群状态和业务正常后做反馈。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/postcheck
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 账号的项目ID **默认取值：** 不涉及 |
| cluster_id | 是    | String | **参数解释：** 集群ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 集群ID **默认取值：** 不涉及    |
   
#### 请求参数
表2请求Body参数 
| 参数         | 是否必选 | 参数类型                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| apiVersion | 是    | String                                                                    | **参数解释：** API版本，固定值"v3"，该值不可修改。 **约束限制：** 该值不可修改 **取值范围：** - v3    **默认取值：** v3                                  |
| kind       | 是    | String                                                                    | **参数解释：** API类型，固定值"PostCheckTask"，该值不可修改。 **约束限制：** 该值不可修改 **取值范围：** - PostCheckTask    **默认取值：** PostCheckTask |
| spec       | 是    | [PostcheckResponseSpec] object | **参数解释：** spec是升级后确认的配置信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                      |
   
 表3PostcheckResponseSpec 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| clusterID      | 否    | String | **参数解释：** 集群ID **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及     |
| clusterVersion | 否    | String | **参数解释：** 升级前的集群版本 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| targetVersion  | 否    | String | **参数解释：** 当前集群版本 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及   |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数         | 参数类型                                                                                           | 描述                                                                                                                          |
|:---|:---|:---|
| apiVersion | String                                                                                         | **参数解释：** API版本 **取值范围：** 不涉及        |
| kind       | String                                                                                         | **参数解释：** 资源类型 **取值范围：** 不涉及         |
| metadata   | [PostcheckCluserResponseMetadata] object | **参数解释：** 升级后确认元数据 **取值范围：** 不涉及     |
| spec       | [PostcheckSpec] object                                     | **参数解释：** 集群升级后确认的配置信息 **取值范围：** 不涉及 |
| status     | [status] object                                                   | **参数解释：** 集群升级后确认的状态信息 **取值范围：** 不涉及 |
   
 表5PostcheckCluserResponseMetadata 
| 参数  | 参数类型   | 描述                                                                                                                  |
|:---|:---|:---|
| uid | String | **参数解释：** 任务ID **取值范围：** 不涉及 |
   
 表6PostcheckSpec 
| 参数             | 参数类型   | 描述                                                                                                                           |
|:---|:---|:---|
| clusterID      | String | **参数解释：** 集群ID **取值范围：** 不涉及          |
| clusterVersion | String | **参数解释：** 升级前的集群版本 **取值范围：** 不涉及      |
| targetVersion  | String | **参数解释：** 当前集群版本 **取值范围：** CCE支持的集群版本 |
   
 表7status 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| 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 | 集群升级后确认成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。