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

扫描代理安全

执行安全CVE扫描处理空损坏规则优雅。

调试可用性

在线调试

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

请求参数

请求体字段

  • agentIdString必填

    代理ID。

    示例： agent-abc123

响应状态

200 OK

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

  • findingsList

    漏洞发现项发现扫描。

    示例： (nested array)

    • agentIdString

      代理ID。

      示例： agent-abc123

    • cveIdString

      CVE编号。

      示例： CVE-2021-44228

    • severityString

      告警级别。

      示例： CVE_SEVERITY_UNSPECIFIED

    • cvssScoreLong

      漏洞发现项。

      示例： 9.8

    • affectedPackageNameString

      受影响软件包名称。

      示例： log4j-core

    • installedVersionString

      已安装版本。

      示例： 2.14.1

    • fixVersionString

      修复版本。

      示例： 2.17.0

    • isFixedBoolean

      是否已修复。

      示例： false

    • scannedAtString

      已扫描时间。

      示例： 2026-01-15T08:00:00Z

  • scanCompletedBoolean

    扫描是否完成。

    示例： true

  • packagesScannedInteger

    已扫描软件包数量。

    示例： 120

  • noteString

    备注。

    示例： Scan completed with degraded rules set

请求地址

POST/api/v1/security/cve/scan-safe

/api/v1/security/cve/scan-safe

操作 ID

ScanAgentSafe

永久链接

请求示例

curl -X POST '{host}/api/v1/security/cve/scan-safe' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"agentId":"agent-abc123"}'

响应示例

200
{
  "findings": [
    {}
  ],
  "scanCompleted": true,
  "packagesScanned": 120,
  "note": "Scan completed with degraded rules set"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史