查询单个漏洞影响的云服务器信息 - ListVulHosts

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

enterprise_project_id

否

String

参数解释:

企业项目ID，用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID。

如需查询所有企业项目下的资产请传参“all_granted_eps”。

约束限制:

开通企业项目功能后才需要配置企业项目ID参数。

取值范围:

字符长度1-256位

默认取值:

0，表示默认企业项目（default）。

limit

否

Integer

参数解释:

每页显示个数

约束限制:

不涉及

取值范围:

取值10-200

默认取值:

10

offset

否

Integer

参数解释:

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

约束限制:

不涉及

取值范围:

最小值0，最大值2000000

默认取值:

默认为0

host_name

否

String

参数解释:

服务器名称

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

host_ip

否

String

参数解释:

服务器IP

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

vul_id

是

String

参数解释:

漏洞ID

约束限制:

不涉及

取值范围:

字符范围0-64

默认取值:

不涉及

type

是

String

参数解释:

查询的漏洞类型

约束限制:

不涉及

取值范围:

• linux_vul : linux漏洞

• windows_vul : windows漏洞

• web_cms : Web-CMS漏洞

• app_vul : 应用漏洞

• urgent_vul : 应急漏洞

默认取值:

不涉及

status

否

String

参数解释:

漏洞当前的漏洞状态

约束限制:

不涉及

取值范围:

• 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 : 请重启主机再次修复

默认取值:

不涉及

asset_value

否

String

参数解释:

资产重要性

约束限制:

不涉及

取值范围:

• important : 重要

• common : 一般

• test : 测试

默认取值:

不涉及

group_name

否

String

参数解释:

服务器组名称

约束限制:

不涉及

取值范围:

字符范围0-256位

默认取值:

不涉及

handle_status

否

String

参数解释:

漏洞当前的处置状态

约束限制:

不涉及

取值范围:

• unhandled : 未处理

• handled : 已处理

默认取值:

不涉及

severity_level

否

String

参数解释:

危险程度

约束限制:

不涉及

取值范围:

• Critical : 漏洞cvss评分大于等于9；对应控制台页面的高危

• High : 漏洞cvss评分大于等于7，小于9；对应控制台页面的中危

• Medium : 漏洞cvss评分大于等于4，小于7；对应控制台页面的中危

• Low : 漏洞cvss评分小于4；对应控制台页面的低危

可用逗号连接作为多选

默认取值:

不涉及

is_affect_business

否

Boolean

参数解释:

是否影响业务

约束限制:

不涉及

取值范围:

• true : 影响业务

• false : 不影响业务

默认取值:

不涉及

repair_priority

否

String

参数解释:

修复优先级

约束限制:

不涉及

取值范围:

• Critical : 紧急

• High : 高危

• Medium : 中危

• Low : 低危

可用逗号连接作为多选

默认取值:

不涉及

X-Auth-Token

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

total_num

Integer

参数解释:

受影响的云服务器总数

取值范围:

最小值0，最大值10000

data_list

Array of VulHostInfo objects

参数解释:

受影响的云服务器列表

取值范围:

最小值1，最大值10000

host_id

String

受漏洞影响的服务器id

severity_level

String

参数解释:

危险程度

取值范围:

• Critical : 漏洞cvss评分大于等于9；对应控制台页面的高危

• High : 漏洞cvss评分大于等于7，小于9；对应控制台页面的中危

• Medium : 漏洞cvss评分大于等于4，小于7；对应控制台页面的中危

• Low : 漏洞cvss评分小于4；对应控制台页面的低危

host_name

String

参数解释:

受影响主机名称

取值范围:

字符范围1-256位

host_ip

String

参数解释:

受影响主机ip

取值范围:

字符范围1-256位

agent_id

String

参数解释:

主机对应的agent id

取值范围:

字符范围1-128位

version

String

参数解释:

主机绑定的配额版本

取值范围:

字符范围1-128位

cve_num

Integer

参数解释:

漏洞cve总数

取值范围:

最小值0，最大值10000

cve_id_list

Array of strings

参数解释:

漏洞对应的cve id列表

取值范围:

最小值1，最大值10000

status

String

参数解释:

漏洞状态

取值范围:

• 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 : 请重启主机再次修复

repair_cmd

String

参数解释:

修复漏洞需要执行的命令行（只有Linux漏洞有该字段）

取值范围:

字符范围1-256位

app_path

String

参数解释:

应用软件的路径（只有应用漏洞有该字段）

取值范围:

字符范围1-512位

region_name

String

参数解释:

地域

取值范围:

字符范围0-128位

public_ip

String

参数解释:

服务器公网ip

取值范围:

字符范围0-128位

private_ip

String

参数解释:

服务器私网ip

取值范围:

字符范围0-128位

group_id

String

参数解释:

服务器组id

取值范围:

字符范围0-128位

group_name

String

参数解释:

服务器组名称

取值范围:

字符范围0-256位

os_type

String

参数解释:

操作系统

取值范围:

• Linux ：linux系统

• Windows：windows系统

asset_value

String

参数解释:

资产重要性

取值范围:

• important : 重要资产

• common : 一般资产

• test : 测试资产

is_affect_business

Boolean

参数解释:

是否影响业务

取值范围:

• true : 影响业务

• false : 不影响业务

first_scan_time

Long

参数解释:

首次扫描时间

取值范围:

最小值0，最大值9223372036854775807

scan_time

Long

参数解释:

扫描时间，时间戳单位：毫秒

取值范围:

最小值0，最大值9223372036854775807

support_restore

Boolean

参数解释:

是否可以回滚到修复漏洞时创建的备份

取值范围:

• true : 可以回滚

• false : 不可以回滚

disabled_operate_types

Array of disabled_operate_types objects

参数解释:

漏洞在当前主机上不可进行的操作类型列表

取值范围:

最小值1，最大值10000

repair_priority

String

参数解释:

修复优先级

取值范围:

• Critical : 紧急

• High : 高

• Medium : 中

• Low : 低

operate_type

String

参数解释:

操作类型

取值范围:

• ignore : 忽略

• not_ignore : 取消忽略

• immediate_repair : 修复

• manual_repair : 人工修复

• verify : 验证

• add_to_whitelist : 加入白名单

reason

String

参数解释:

不可进行操作的原因

取值范围:

字符范围0-512位

200

请求已成功