文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 基线检查/ 查询基线检查的统计数据信息 - ShowBaselineOverview
更新时间:2025-10-31 GMT+08:00
分享

查询基线检查的统计数据信息 - ShowBaselineOverview

功能介绍

查询基线检查的统计数据信息,用来展示基线检查页面的统计数据和图表数据,包括最近检测时间、检测主机数、检测基线数、主机配置检查项数、主机配置基线通过率、主机配置风险top5、主机弱口令检测统计、主机弱口令风险top5等

授权信息

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

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

URI

GET /v5/{project_id}/baseline/overview

表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)。

group_id

String

参数解释:

策略组ID。当传此字段时,返回当前策略组ID下的数据。当不传此字段时,返回当前企业项目下所有数据。

约束限制:

不涉及

取值范围:

字符长度0-256位

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

scan_time

Long

参数解释:

最新检测时间(ms)。

取值范围:

取值0-9223372036854775807

host_num

Integer

参数解释:

检查服务器数量。

取值范围:

取值0-2147483647

failed_host_num

Integer

参数解释:

未通过主机数。

取值范围:

取值0-2147483647

check_type_num

Integer

参数解释:

检测基线数量。例如共检测了SSH、CentOS 7这2个配置检测(基线)类型,值就是2。

取值范围:

取值0-2147483647

check_rule_num

Integer

参数解释:

基线检测项(检测规则)数量。例如SSH基线检测了17条规则,CentOS 7基线检测了60条规则,值就是17+60=77。

取值范围:

取值0-2147483647

check_rule_pass_rate

Integer

参数解释:

基线检查项通过率。

取值范围:

取值0-2147483647

cn_standard_check_rule_pass_rate

Integer

参数解释:

云安全实践基线检查项通过率。

取值范围:

取值0-2147483647

hw_standard_check_rule_pass_rate

Integer

参数解释:

等保合规基线检查项通过率。

取值范围:

取值0-2147483647

check_rule_failed_num

Integer

参数解释:

未通过的检查项数量。

取值范围:

取值0-2147483647

check_rule_high_risk

Integer

参数解释:

高危检查项数量。

取值范围:

取值0-2147483647

check_rule_medium_risk

Integer

参数解释:

中危检查项数量。

取值范围:

取值0-2147483647

check_rule_low_risk

Integer

参数解释:

低危检查项数量。

取值范围:

取值0-2147483647

weak_pwd_total_host

Integer

参数解释:

弱口令检测主机总数。

取值范围:

取值0-2147483647

weak_pwd_risk

Integer

参数解释:

弱口令检测结果:有弱口令的主机数。

取值范围:

取值0-2147483647

weak_pwd_normal

Integer

参数解释:

弱口令检测结果:无弱口令的主机数。

取值范围:

取值0-2147483647

weak_pwd_not_protected

Integer

参数解释:

弱口令检测结果:未开启防护的主机数。

取值范围:

取值0-2147483647

host_risks

Array of HostRiskNumInfoResponseInfo objects

服务器风险TOP5列表

weak_pwd_risk_hosts

Array of HostWeakPwdRiskNumInfoResponseInfo objects

主机弱口令风险TOP5列表

表5 HostRiskNumInfoResponseInfo

参数

参数类型

描述

host_id

String

参数解释

主机ID

取值范围

字符长度1-64位

host_name

String

参数解释:

服务器名称

取值范围:

字符长度1-256位

host_ip

String

参数解释:

服务器IP

取值范围:

字符长度1-128位

scan_time

Long

参数解释:

扫描时间(ms)。

取值范围:

取值0-9223372036854775807

high_risk_num

Integer

参数解释:

高危风险数量。

取值范围:

取值0-2147483647

medium_risk_num

Integer

参数解释:

中危风险数量。

取值范围:

取值0-2147483647

low_risk_num

Integer

参数解释:

低危风险数量。

取值范围:

取值0-2147483647

表6 HostWeakPwdRiskNumInfoResponseInfo

参数

参数类型

描述

host_id

String

参数解释

主机ID

取值范围

字符长度1-64位

host_name

String

参数解释:

服务器名称

取值范围:

字符长度1-256位

host_ip

String

参数解释:

服务器IP

取值范围:

字符长度1-128位

weak_pwd_num

Integer

参数解释:

弱口令数量。

取值范围:

取值0-2147483647

请求示例

响应示例

状态码:200

请求已成功

{
  "scan_time" : 1760607432824,
  "host_num" : 100,
  "check_type_num" : 100,
  "check_rule_num" : 100,
  "check_rule_pass_rate" : 100,
  "cis_standard_check_rule_pass_rate" : 100,
  "cn_standard_check_rule_pass_rate" : 100,
  "hw_standard_check_rule_pass_rate" : 100,
  "check_rule_failed_num" : 100,
  "check_rule_high_risk" : 100,
  "check_rule_medium_risk" : 100,
  "check_rule_low_risk" : 100,
  "weak_pwd_total_host" : 100,
  "weak_pwd_risk" : 100,
  "weak_pwd_normal" : 100,
  "weak_pwd_not_protected" : 100,
  "host_risks" : [ {
    "host_id" : "00bd5209-d8df-43af-bf91-5c0cfc965a1b",
    "host_name" : "name",
    "host_ip" : "192.168.1.1",
    "scan_time" : 1760607432824,
    "high_risk_num" : 100,
    "medium_risk_num" : 100,
    "low_risk_num" : 0
  } ],
  "weak_pwd_risk_hosts" : [ {
    "host_id" : "00bd5209-d8df-43af-bf91-5c0cfc965a1b",
    "host_name" : "name",
    "host_ip" : "192.168.1.1",
    "weak_pwd_num" : 100
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档