文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 漏洞管理/ 处理的漏洞 - ListHandleVuls
更新时间：2025-10-31 GMT+08:00
查看PDF
分享

处理的漏洞 - ListHandleVuls

功能介绍

查询今日处理漏洞/累计处理漏洞

授权信息

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

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

URI

GET /v5/{project_id}/vulnerability/handle/vulnerabilities

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID。

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释:

每页显示个数

约束限制:

不涉及

取值范围:

取值10-200

默认取值:

10

offset

否

Integer

参数解释:

偏移量：指定返回记录的开始位置

约束限制:

不涉及

取值范围:

最小值0，最大值2000000

默认取值:

默认为0

vul_name

否

String

参数解释:

漏洞名称

约束限制:

不涉及

取值范围:

字符长度0-256位

默认取值:

不涉及

cve_id

否

String

参数解释:

漏洞cve编号

约束限制:

不涉及

取值范围:

字符长度1-128位

默认取值:

不涉及

label_list

否

String

参数解释:

漏洞标签

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

status

否

String

参数解释：

漏洞状态

约束限制：

不涉及

取值范围：

  • vul_status_ignored: 已忽略。

  • vul_status_fixed: 修复成功。

默认取值：

不涉及

asset_value

否

String

参数解释：

资产重要性

约束限制:

不涉及

取值范围:

  • important：重要资产。

  • common：一般资产。

  • test：测试资产。

默认取值:

不涉及

group_name

否

String

参数解释:

服务器组名称

约束限制:

不涉及

取值范围:

字符长度1-128位

默认取值:

不涉及

host_name

否

String

参数解释:

主机名称

约束限制:

不涉及

取值范围:

字符长度1-128位

默认取值:

不涉及

host_ip

否

String

参数解释:

主机ip

约束限制:

不涉及

取值范围:

字符长度0-128位

默认取值:

不涉及

type

否

String

参数解释:

漏洞类型

约束限制:

不涉及

取值范围:

字符长度1-64位

默认取值:

不涉及

handle_circle

否

String

参数解释：

处理周期

约束限制:

不涉及

取值范围:

  • today：今日处理。

  • all：累计处理。

默认取值:

不涉及

repair_priority

否

String

参数解释：

修复优先级

约束限制:

不涉及

取值范围:

  • Critical：紧急。

  • High：高。

  • Medium：中。

  • Low：低。

默认取值:

不涉及

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

data_list

Array of data_list objects

array

total_num

Integer

参数解释：

总数

取值范围：

最小值0，最大值100000000总数
表4 data_list

参数

参数类型

描述

label_list

Array of strings

参数解释:

漏洞标签列表

取值范围:

最小值0，最大值2147483647

repair_priority

String

参数解释:

修复优先级

取值范围:

  • Critical：紧急。

  • High：高。

  • Medium：中。

  • Low：低。

repair_success_num

Integer

参数解释:

当前漏洞修复成功次数

取值范围:

最小值0，最大值1000000

vul_id

String

参数解释:

漏洞ID

取值范围:

字符范围0-64位

vul_name

String

参数解释:

漏洞名称

取值范围:

字符范围0-256位

cve_list

Array of cve_list objects

参数解释:

CVE列表

取值范围:

最小值1，最大值10000

is_affected_business

Boolean

参数解释:

是否影响业务

取值范围:

  • true：是。

  • false：否。

host_id

String

参数解释:

主机ID

取值范围:

字符长度1-64

public_ip

String

参数解释:

服务器公网IP

取值范围:

字符长度0-128

private_ip

String

参数解释:

服务器私网IP

取值范围:

字符长度0-128

host_name

String

参数解释:

主机名称

取值范围:

字符长度1-128位

asset_value

String

参数解释:

修复优先级

取值范围:

  • Critical：紧急。

  • High：高。

  • Medium：中。

  • Low：低。

status

String

参数解释：

漏洞状态

取值范围：

字符长度0-32位

first_scan_time

Long

参数解释:

首次扫描时间

取值范围:

最小值0，最大值9223372036854775807

scan_time

Long

参数解释:

最近扫描时间

取值范围:

最小值0，最大值9223372036854775807

disabled_operate_types

Array of disabled_operate_types objects

参数解释:

该漏洞不可进行的操作类型列表

取值范围:

最小值1，最大值10000
表5 cve_list

参数

参数类型

描述

cve_id

String

参数解释:

CVE ID

取值范围:

字符范围1-32位

cvss

Float

参数解释:

CVSS分值

取值范围:

最小值0，最大值10
表6 disabled_operate_types

参数

参数类型

描述

operate_type

String

参数解释:

操作类型

取值范围:

  • ignore: 忽略

  • not_ignore: 取消忽略

  • immediate_repair: 修复

  • manual_repair: 人工修复

  • verify: 验证

  • add_to_whitelist: 加入白名单

reason

String

参数解释:

不可进行操作的原因

取值范围:

字符范围0-512位

请求示例

无

响应示例

状态码：200

请求已成功

{
  "data_list" : [ {
    "status" : "vul_status_fixed",
    "description" : "The kernel package contains the Linux kernel (vmlinuz), the core of any Linux operating system.",
    "version" : "hss.version.premium",
    "host_id" : "17300e07-da2a-4d74-87c5-b6fad8a18704",
    "agent_id" : "5388b0d5f5c631e0584cbaad9d2e55ab77f1460fe9d9ffc90cfe578354411717",
    "host_name" : "ecs-00896674",
    "group_name" : "1111111111111111",
    "asset_value" : "common",
    "scan_time" : 1734439020824,
    "private_ip" : "192.168.0.217",
    "public_ip" : "100.93.7.22",
    "vul_name" : "EulerOS-SA-2024-2832 kernel security update",
    "vul_id" : "EulerOS-SA-2024-2832",
    "label_list" : [ "需要重启", "漏洞很容易被利用", "远程网络攻击", "竞争条件问题" ],
    "severity_level" : "Critical",
    "repair_success_num" : 0,
    "cve_list" : [ {
      "cvss" : 5.5,
      "cve_id" : "CVE-2020-36777"
    }, {
      "cvss" : 7.8,
      "cve_id" : "CVE-2024-44987"
    } ],
    "is_affect_business" : "false,",
    "first_scan_time" : "1733363485076,",
    "support_restore" : "false,",
    "repair_priority" : "High"
  } ],
  "total_num" : 1
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 漏洞管理

相关文档