文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 总览/ 查询守护天数,病毒库更新时间,漏洞库更新时间,各模块累计次数 - ShowProtectStatistics
更新时间:2025-10-31 GMT+08:00
分享

查询守护天数,病毒库更新时间,漏洞库更新时间,各模块累计次数 - ShowProtectStatistics

功能介绍

查询守护天数,病毒库更新时间,漏洞库更新时间,各模块累计次数

授权信息

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

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

URI

GET /v5/{project_id}/overview/protection/statistics

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

参数解释:

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

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

约束限制:

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

取值范围:

字符长度1-256位

默认取值:

0,表示默认企业项目(default)。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

vul_library_update_time

Long

参数解释:

漏洞库更新时间

取值范围:

最小值0,最大值4071095999000

protect_days

Long

参数解释:

守护天数

取值范围:

最小值0,最大值4071095999000

threat_library_update_time

Long

参数解释:

病毒库更新时间

取值范围:

最小值0,最大值4071095999000

vul_detected_total_num

Long

参数解释:

漏洞累计已检测数量

取值范围:

最小值0,最大值4071095999000

baseline_detected_total_num

Long

参数解释:

累计检测基线总数量

取值范围:

最小值0,最大值4071095999000

finger_scan_total_num

Long

参数解释:

累计扫描指纹数量

取值范围:

最小值0,最大值4071095999000

alarm_detected_total_num

Long

参数解释:

入侵检测累计检测告警总数量

取值范围:

最小值0,最大值4071095999000

ransomware_alarm_detected_total_num

Long

参数解释:

累计防御勒索病毒告警次数

取值范围:

最小值0,最大值4071095999000

file_alarm_detected_total_num

Long

参数解释:

文件完整性监控累计检测文件变更告警总数

取值范围:

最小值0,最大值4071095999000

rasp_alarm_detected_total_num

Long

参数解释:

应用防护累计检测告警总数

取值范围:

最小值0,最大值4071095999000

wtp_alarm_detected_total_num

Long

参数解释:

网页防篡改累计抵御网页防篡改次数

取值范围:

最小值0,最大值4071095999000

image_risk_total_num

Long

参数解释:

容器镜像安全累计检测风险个数

取值范围:

最小值0,最大值4071095999000

container_alarm_total_num

Long

参数解释:

容器安全防护累计检测容器告警个数

取值范围:

最小值0,最大值4071095999000

container_firewall_policy_total_num

Long

参数解释:

容器防火墙累计设置策略条数

取值范围:

最小值0,最大值4071095999000

auto_kill_virus_status

Boolean

参数解释:

是否开启恶意自动查杀

取值范围:

  • true:是。

  • false:否。

请求示例

查询守护天数,病毒库更新时间,漏洞库更新时间,各模块累计次数

GET https://{endpoint}/v5/{project_id}/overview/protection/statistics

响应示例

状态码:200

请求已成功

{
  "vul_library_update_time" : 1757468250000,
  "threat_library_update_time" : 1740708601000,
  "protect_days" : 1947,
  "vul_detected_total_num" : 112734,
  "baseline_detected_total_num" : 2042297,
  "finger_scan_total_num" : 1097850,
  "alarm_detected_total_num" : 663286,
  "ransomware_alarm_detected_total_num" : 0,
  "file_alarm_detected_total_num" : 749,
  "rasp_alarm_detected_total_num" : 54268,
  "wtp_alarm_detected_total_num" : 130876,
  "image_risk_total_num" : 751368,
  "container_alarm_total_num" : 487864,
  "container_firewall_policy_total_num" : 18,
  "auto_kill_virus_status" : true,
  "antivirus_malware_total_num" : 14421
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档