文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 安全运营/ 查询漏洞历史处置记录列表 - ListVulHandleHistory
更新时间：2025-10-31 GMT+08:00
查看PDF
分享

查询漏洞历史处置记录列表 - ListVulHandleHistory

功能介绍

查询漏洞历史处置记录列表

授权信息

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

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

URI

GET /v5/{project_id}/vulnerability/handle-history

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

是

String

企业项目ID

status

否

Array of strings

漏洞状态，包含如下：

  • vul_status_unfix：未处理

  • vul_status_ignored：已忽略

  • vul_status_verified：验证中

  • vul_status_fixing：修复中

  • vul_status_fixed：修复成功

  • vul_status_reboot：修复成功待重启

  • vul_status_failed：修复失败

  • vul_status_fix_after_reboot：请重启主机再次修复

vul_id

否

String

漏洞ID

vul_type

否

String

漏洞类型，包含如下:

  • linux_vul：Linux漏洞

  • windows_vul：Windows漏洞

  • web_cms：Web-CMS漏洞

  • app_vul：应用漏洞

  • urgent_vul：应急漏洞

asset_value

否

String

资产重要性，包含如下:

  • important：重要资产

  • common：一般资产

  • test：测试资产

group_name

否

String

服务器组

host_name

否

String

服务器名称

host_ip

否

String

服务器IP

cluster_id

否

String

集群ID

sort_key

否

String

排序字段，包含如下：

  • handle_time：处置时间

sort_dir

否

String

排序顺序，若sort_key不为空，设置返回结果按照sort_key升序或降序排序，默认降序排序，包含如下：

  • asc：升序

  • desc：降序

public_ip

否

String

服务器公网IP

private_ip

否

String

服务器私网IP

limit

是

Integer

每页个数

offset

是

Integer

偏移量

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token，包含了用户的身份、权限等信息，在调用API接口时，可通过Token进行身份认证。获取方式请参见获取用户Token。

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

data_list

Array of data_list objects

详情

total_num

Integer

总数
表5 data_list

参数

参数类型

描述

id

String

历史记录唯一id

user_name

String

用户名

type

String

漏洞类型

host_id

String

服务器ID

host_name

String

服务器名称

public_ip

String

服务器公网IP

private_ip

String

服务器私网IP

handle_time

String

处置时间

status

String

处置状态

failed_reason

String

失败原因

description

String

备注

vul_id

String

漏洞ID

vul_name

String

漏洞名称

asset_value

String

资产重要性

cve_list

Array of VulCveInfo objects

cve列表

app_name

String

软件名称

app_path

String

应用软件路径

app_version

String

软件版本

handle_type

String

处置类型

cluster_id

String

集群ID

container_name

String

容器名称

container_id

String

容器ID
表6 VulCveInfo

参数

参数类型

描述

cve_id

String

cve ID

cvss

Float

cve评分

vul_id

String

漏洞ID

请求示例

无

响应示例

状态码：200

请求已成功

{
  "total_num" : 41496,
  "data_list" : [ {
    "id" : "d6f***20-1d03-4692-b8a5-9795****188e",
    "user_name" : "scc_hss_g0*******8_01",
    "type" : "linux_vul",
    "host_id" : "29****064-edfc-4f45-9fe4-0ee****740c9",
    "host_name" : "ecs-HSStest-600****51",
    "public_ip" : "",
    "private_ip" : "192.168.0.**",
    "handle_time" : "1737424707845",
    "status" : "vul_status_ignored",
    "description" : "本次将875个Linux漏洞加入白名单，作为记录便于查看",
    "vul_id" : "EulerOS-SA-2024-1583",
    "vul_name" : "EulerOS-SA-2024-1583 bind security update",
    "asset_value" : "common",
    "cve_list" : [ {
      "cvss" : 0,
      "cve_id" : "CVE-2023-50387"
    }, {
      "cvss" : 0,
      "cve_id" : "CVE-2023-50868"
    } ],
    "app_name" : "python3-bind",
    "app_version" : "9.11.21-4.h15.eulerosv2r10",
    "handle_type" : "add_to_whitelist"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 安全运营

相关文档