跳转到主要内容
安全与审计相关接口/安全
GETSecurity起始版本 1.0同步需要认证

获取安全态势仪表盘

获取安全姿态仪表盘概览聚合指标。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

此接口无需请求参数。

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • totalAgentsInteger

    代理总数。

    示例: 200

  • vulnerableAgentsInteger

    存在漏洞的代理数量。

    示例: 35

  • criticalCveCountInteger

    严重CVE数量。

    示例: 5

  • highCveCountInteger

    高危CVE数量。

    示例: 12

  • avgCvssScoreLong

    平均CVSS评分。

    示例: 7.4

  • fixRatePct30dLong

    30天修复率百分比。

    示例: 68.5

  • top5CvesList

    Top5 CVE。

    示例: (nested array)

    • cveIdString

      CVE编号。

      示例: CVE-2021-44228

    • affectedCountInteger

      受影响数量。

      示例: 15

    • severityString

      告警级别。

      示例: CVE_SEVERITY_UNSPECIFIED

请求地址

GET/api/v1/security/posture-dashboard

/api/v1/security/posture-dashboard

操作 ID

GetPostureDashboard

永久链接

请求示例

curl -X GET '{host}/api/v1/security/posture-dashboard' -H 'Authorization: Bearer {token}'

响应示例

200
{
  "totalAgents": 200,
  "vulnerableAgents": 35,
  "criticalCveCount": 5,
  "highCveCount": 12,
  "avgCvssScore": 7.4,
  "fixRatePct30d": 68.5,
  "top5Cves": [
    {}
  ]
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史