查询漏洞公告影响的主机详情
更新时间 2025-12-25 09:39:40
最近更新时间: 2025-12-25 09:39:40
接口功能介绍
查询受影响服务器详情。
接口约束
此功能为免费功能。
URI
POST /v1/announcement/affectedHostDetail
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| vulAnnouncementId | 是 | String | 漏洞公告id | idaaddda | |
| agentGuid | 是 | String | agentGuid | test-agent-guid |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| error | String | 返回码 | ||
| CTCSSCN_000000：成功 | ||||
| CTCSSCN_000001：失败 | ||||
| CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用 | ||||
| CTCSSCN_000004：鉴权错误 | ||||
| CTCSSCN_000005：用户没有付费版配额，功能不可用 | CTCSSCN_000000 | |||
| message | String | 返回信息 | success | |
| returnObj | Object | 返回对象 | returnObj | |
| traceId | String | traceId | asaadasd11111 | |
| statusCode | String | 状态码 200-成功 | 200 | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | String | id | ||
| 漏洞id | VH211212112 | |||
| vulAnnouncementId | String | 漏洞公告ID（这里与参考类不同，根据MongoDB文档调整） | vul-asaada | |
| taskId | String | 漏洞扫描任务ID | ||
| agentGuid | String | GUID | test-agent-guid | |
| timestamp | String | 时间戳 | 2021-01-01 00:00:00 | |
| status | Integer | 漏洞状态 0-未处理 1-已处理 2-已加白 3-修复中 4-修复成功 5-修复失败 6-已忽略 7-验证中 8-修复成功需要重启 9-扫描中 | 0 | |
| vulType | String | 漏洞类型 LINUX-linux漏洞，WINDOWS-windows漏洞, EMERGENCY_VUL-应急漏洞,APPLICATION-应用漏洞,WEB_CMS-webcms漏扫 | LINUX | |
| updateTime | String | 更新时间 | 2020-01-01 00:00:00 | |
| modified | String | 修改时间（字符串格式） | 2020-01-01 00:00:00 | |
| cveList | Array of Strings | 关联CVE列表 | ["CVE-2020-1234"] | |
| fixLevel | String | 修复优先级 LOW-低 MIDDLE-中 HIGH-高 | LOW | |
| rebootRequired | Boolean | 是否需要重启 | true | |
| vulAnnouncementTitle | String | 漏洞公告标题 | vul-saas | |
| privateIp | String | 私有IP地址 | 192.168.1.1 | |
| publicIp | String | 公有IP地址 | 192.168.1.1 | |
| custName | String | 主机名称 | test-cust-name | |
| osType | String | 操作系统类型 Linux/Windows | Linux | |
| bgGroupId | String | 业务分组id | 121313213 | |
| fixCommand | String | 修复命令 | fix-command | |
| relatedSoftware | Array of Objects | 关联软件列表 | relatedSoftware | |
| 表 relatedSoftware |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| SoftwareName | String | 软件名称 | tool | |
| currentVersion | String | 已安装版本 | 1.0.0 | |
| fixVersion | String | 修复版本 | 1.0.1 | |
| rebootRequired | Boolean | 是否需要重启 | true | |
| relationProcessName | String | 关联进程名称 | process | |
| relationProcessId | String | 关联进程id | 123456789 | |
| fixCommand | String | 修复命令 | fix-command | |
| location | String | 软件路径 | /tmp/test.txt |
枚举参数
无
请求示例
请求url
无
请求头header
{"Content-Type": "application/json"}
请求体body
{"vulAnnouncementId": "idaaddda", "agentGuid": "test-agent-guid"}
响应示例
{"message": "success", "traceId": "asaadasd11111", "statusCode": "200", "error": "CTCSSCN_000000", "returnObj": {"id": "VH211212112", "vulAnnouncementId": "vul-asaada", "taskId": "", "agentGuid": "test-agent-guid", "timestamp": "2021-01-01 00:00:00", "status": 0, "vulType": "LINUX", "updateTime": "2020-01-01 00:00:00", "modified": "2020-01-01 00:00:00", "cveList": ["CVE-2020-1234"], "fixLevel": "LOW", "rebootRequired": "true", "vulAnnouncementTitle": "vul-saas", "privateIp": "192.168.1.1", "publicIp": "192.168.1.1", "custName": "test-cust-name", "osType": "Linux", "bgGroupId": "121313213", "fixCommand": "fix-command", "relatedSoftware": [{"SoftwareName": "tool", "currentVersion": "1.0.0", "fixVersion": "1.0.1", "rebootRequired": "true", "relationProcessName": "process", "relationProcessId": "123456789", "fixCommand": "fix-command", "location": "/tmp/test.txt"}]}}
状态码
请参考 状态码
错误码
请参考 错误码
