文档首页/ 云运维中心 COC/ API参考/ API/ 补丁管理/ 分页获取节点补丁详情 - ShowInstancePatchItems
更新时间：2025-10-23 GMT+08:00
查看PDF
分享

分页获取节点补丁详情 - ShowInstancePatchItems

功能介绍

分页获取节点补丁详情

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    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。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

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

参数解释：

补丁合规信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 ComplianceItem

参数

参数类型

描述

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

参数解释：

补丁详情。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表5 PatchDetail

参数

参数类型

描述

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

错误信息返回

错误码

请参见错误码。

父主题： 补丁管理

相关文档