接口功能介绍
病毒查杀-病毒查杀病毒详情接口。
接口约束
此功能为收费功能。确认已经购买服务器配额，并且开启服务器防护。如果没有购买配额，可按照页面提示进行购买。如果没有开启防护，请在服务器列表页开启机器防护。
URI
POST /v1/virus/detail
路径参数
无
Query参数
无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 请求地址类型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| docId | 是 | String | 病毒文档id | 6332692e7d266507ddb239a8 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 200-成功 | ||
| error | String | 返回码 CTCSSCN_000000：成功 CTCSSCN_000001：失败 CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用 CTCSSCN_000004：鉴权错误 CTCSSCN_000005：用户没有付费版配额，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回对象 | data |
表 data
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| custName | String | 主机名 | 0 | |
| publicIp | String | 公网IP | ||
| agentIp | String | 私网IP | ||
| agentGuid | String | 主机uid | ||
| findTime | String | 发现时间 | ||
| handleTime | String | 处理时间 | ||
| path | String | 文件路径 | ||
| virusName | String | 病毒名称 | ||
| engineVersion | String | 引擎版本 | ||
| knownViruses | Integer | 病毒库包含病毒数量 | 1 | |
| scannedDirectories | Integer | 扫描目录数 | 1 | |
| scannedFiles | Integer | 扫描文件数 | 1 | |
| dataScanned | Integer | 扫描路径文件总大小 | 1 | |
| severity | Integer | 危险等级： 1低危 2中危 3高危 4超危 5超高危 |
1 | |
| startDate | String | 扫描开始时间 | ||
| endDate | String | 扫描结束时间 | ||
| time | Integer | 扫描用时 单位秒 | 1 | |
| taskId | String | 告警ID | ||
| timestamp | String | 告警时间 |
枚举参数
无
请求示例
请求url
无
请求头header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
请求体body
{"docId":"6332692e7d266507ddb239a8"}
响应示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查询成功!","returnObj":{"agentGuid": "0880B36D-45C5-438E-AC82-4F0A8B05B564","publicIp": null,"agentIp": null,"custName": null,"osType": null,"path": "/root/dir1/file1.txt","findTime": "2021-12-08 19:14:33","handleTime": null,"checkInfo": {"virusName": "Eicar-Signature","engineVersion": "0.103.3","knownViruses": "8580104"},"checkDetailInfo": {"scannedDirectories": "6","scannedFiles": "87","dataScanned": "8.88 MB","severity": "3","startDate": "2021:12:08 19:12:46","endDate": "2021:12:08 19:14:33","time": "82.649 sec (1 m 22 s)","taskId": 131477100,"timestamp": "2021-12-08 19:14:33"}}}
状态码
请参考 状态码
错误码
请参考 错误码
