# 分页获取节点补丁详情 - ShowInstancePatchItems
#### 功能介绍
分页获取节点补丁详情
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ShowInstancePatchItems)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                      | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | coc:complianceReport:get | Read | -           | -   | -  | -      |
     
#### URI
GET /v1/patch/instance/compliant/{instance_compliant_id}
表1路径参数 
| 参数                    | 是否必选 | 参数类型   | 描述                                                                                                                                                                   |
|:---|:---|:---|:---|
| instance_compliant_id | 是    | String | **参数解释：** 合规性报告ID，ECS/BMS实例补丁扫描或补丁修复后会在补丁扫描页面形成一行合规性报告。 **约束限制：** 不涉及。 **取值范围：** 由小写字母（a\~z）、数字（0-9）组成的长度为32的字符串，举例：3f5f3c944f50da3a7038457c5ff76c66。 **默认取值：** 不涉及。 |
表2Query参数 
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                      |
|:---|:---|:---|:---|
| offset           | 否    | Integer | **参数解释：** 用于分页查询补丁信息列表，偏移指针。 **约束限制：** 不涉及。 **取值范围：** 整数，长度在1\~1000000之间。 **默认取值：** 1。                                                                                                  |
| limit            | 否    | Integer | **参数解释：** 用于分页查询补丁信息列表，每页查询数量。 **约束限制：** 不涉及。 **取值范围：** 整数，长度在1\~100之间。 **默认取值：** 10。                                                                                                   |
| title            | 否    | String  | **参数解释：** 补丁名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                            |
| sort_dir         | 否    | String  | **参数解释：** 补丁信息排序方式。 **约束限制：** 不涉及。 **取值范围：** - asc：升序 - desc：降序 **默认取值：** 不涉及。                                                                                                          |
| sort_key         | 否    | String  | **参数解释：** 排序字段，可选择按照哪些响应字段进行排序，与"sort_dir"参数配合使用。 **约束限制：** 不涉及。 **取值范围：** "installed_time"（补丁安装时间） **默认取值：** 不涉及。                                                                      |
| patch_status     | 否    | String  | **参数解释：** 补丁状态。 **约束限制：** 不涉及。 **取值范围：** - INSTALLED：已安装 - INSTALLED_OTHER：已安装非基线补丁 - MISSING：待修复 - REJECT：已拒绝 - FAILED：修复失败 - PENDING_REBOOT：已安装待重启 **默认取值：** 不涉及。                     |
| classification   | 否    | String  | **参数解释：** 分类。 **约束限制：** 不涉及。 **取值范围：** - Security：为安全漏洞修复相关类型的补丁 - Bugfix：为Bug修复相关类型的补丁 - Enhancement：为功能增强相关类型的补丁 - Recommended：为推荐更新相关类型的补丁 - Newpackage：为新增软件包相关类型的补丁 **默认取值：** 不涉及。 |
| severity_level   | 否    | String  | **参数解释：** 严重性级别。 **约束限制：** 不涉及。 **取值范围：** - Critical：致命 - Important：重要 - Moderate：一般 - Low：较低 - None：无 **默认取值：** 不涉及。                                                                   |
| compliance_level | 否    | String  | **参数解释：** 合规性级别。 **约束限制：** 不涉及。 **取值范围：** - UNSPECIFIED：未指定 - CRITICAL：重大 - HIGH：高 - MEDIUM：中 - LOW：低 - INFORMATIONAL：提示 **默认取值：** 不涉及。                                                 |
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数               | 参数类型                                                                                                             | 描述                                                             |
|:---|:---|:---|
| count            | Long                                                                                                             | **参数解释：** 返回补丁总条数。 **约束限制：** 不涉及。 **取值范围：** 整数。 **默认取值：** 不涉及。 |
| compliance_items | Array of [ComplianceItem] objects | **参数解释：** 补丁合规信息。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
 表4ComplianceItem 
| 参数               | 参数类型                                                                                             | 描述                                                                                                                                                                                      |
|:---|:---|:---|
| instance_id      | String                                                                                           | **参数解释：** 资源ID，补丁扫描或补丁修复后的ECS/BMS实例ID。 **约束限制：** 不涉及。 **取值范围：** 由小写字母（a\~z）、数字（0-9）、中划线（-）组成的长度为36的字符串，举例：8c123456-e426-4cdd-b123-4e1e36e00f99。 **默认取值：** 不涉及。                          |
| title            | String                                                                                           | **参数解释：** 补丁名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                            |
| classification   | String                                                                                           | **参数解释：** 分类。 **约束限制：** 不涉及。 **取值范围：** - Security：为安全漏洞修复相关类型的补丁 - Bugfix：为Bug修复相关类型的补丁 - Enhancement：为功能增强相关类型的补丁 - Recommended：为推荐更新相关类型的补丁 - Newpackage：为新增软件包相关类型的补丁 **默认取值：** 不涉及。 |
| severity_level   | String                                                                                           | **参数解释：** 严重性级别。 **约束限制：** 不涉及。 **取值范围：** - Critical：致命 - Important：重要 - Moderate：一般 - Low：较低 - None：无 **默认取值：** 不涉及。                                                                   |
| compliance_level | String                                                                                           | **参数解释：** 合规性级别。 **约束限制：** 不涉及。 **取值范围：** - UNSPECIFIED：未指定 - CRITICAL：重大 - HIGH：高 - MEDIUM：中 - LOW：低 - INFORMATIONAL：提示 **默认取值：** 不涉及。                                                 |
| patch_detail     | [PatchDetail] object | **参数解释：** 补丁详情。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                            |
   
 表5PatchDetail 
| 参数                  | 参数类型   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| installed_time      | Long   | **参数解释：** 安装时间。 **约束限制：** 不涉及。 **取值范围：** 13位毫秒级UNIX时间戳。 **默认取值：** 不涉及。                                                                                              |
| patch_baseline_id   | String | **参数解释：** 补丁基线ID。 **约束限制：** 不涉及。 **取值范围：** 由"JX-"开头，小写字母（a\~z）、数字（0-9）组成的长度为32的字符串，举例：JX-123456e9541f9b5775193ad3fb8a3。 **默认取值：** 不涉及。                              |
| patch_baseline_name | String | **参数解释：** 补丁基线名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                      |
| patch_status        | String | **参数解释：** 补丁状态。 **约束限制：** 不涉及。 **取值范围：** - INSTALLED：已安装 - INSTALLED_OTHER：已安装非基线补丁 - MISSING：待修复 - REJECT：已拒绝 - FAILED：修复失败 - PENDING_REBOOT：已安装待重启 **默认取值：** 不涉及。 |
   
**状态码：500**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
查询指定报告下的补丁信息，每页返回10个记录，从第1页开始。
```
GET https://coc.myhuaweicloud.com/v1/patch/instance/compliant/3f5f3c944f50da3a7038457c5ff76c66?offset=1&limit=10
```
#### 响应示例
**状态码：200**
节点补丁信息
```
{
  "count" : 1,
  "compliance_items" : [ {
    "classification" : "",
    "compliance_level" : "UNSPECIFIED",
    "instance_id" : "string",
    "patch_detail" : {
      "installed_time" : 1713864585000,
      "patch_baseline_id" : "JX-f2d85e2554f7385cbbf2c23a01f41",
      "patch_baseline_name" : "COC-EulerOSDefaultPatchBaseline",
      "patch_status" : "PENDING_REBOOT"
    },
    "severity_level" : "",
    "title" : "string"
  } ]
}
```
**状态码：500**
错误信息返回
```
{
  "error_code" : "string",
  "error_msg" : "string"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 节点补丁信息 |
| 500 | 错误信息返回 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。