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

记录清单

记录代理软件清单漏洞扫描。

调试可用性

在线调试

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

路径参数

请求参数

路径参数

  • agentIdString必填

    代理ID。

请求体字段

  • agentIdString必填

    代理ID。

    示例: agent-abc123

  • collectedAtString必填

    采集时间。

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

  • osNameString必填

    操作系统名称代理主机。

    示例: Ubuntu

  • osVersionString必填

    操作系统版本。

    示例: 22.04

  • packagesList必填

    软件包安装代理主机列表。

    示例: (nested array)

    • nameString

      资源名称。

      示例: log4j-core

    • versionString

      版本号。

      示例: 2.14.1

响应状态

200 OK

该 API 成功时返回一个空的 JSON 结构 {}。

请求地址

POST/api/v1/security/agents/{agentId}/inventory

/api/v1/security/agents/{agentId}/inventory

操作 ID

RecordInventory

永久链接

请求示例

curl -X POST '{host}/api/v1/security/agents/{agentId}/inventory' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"agentId":"agent-abc123","collectedAt":"2026-01-15T08:00:00Z","osName":"Ubuntu","osVersion":"22.04","packages":"(nested array)","runningServices":"item1,item2","agentVersion":"1.2.3"}'

响应示例

200
{}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史