接口功能介绍
病毒查杀-病毒查杀列表接口。
接口约束
此功能为收费功能。确认已经购买服务器配额，并且开启服务器防护。如果没有购买配额，可按照页面提示进行购买。如果没有开启防护，请在服务器列表页开启机器防护。
URI
POST /v1/virus/list
路径参数
无
Query参数
无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 请求地址类型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| pageSize | 是 | Integer | 每页大小 | 10 | |
| currentPage | 是 | Integer | 当前页码 | 1 | |
| param | 否 | String | 参数 | ||
| osType | 是 | Integer | 系统类型： 1：Linux 2：Windows 3:both |
3 | |
| intervalType | 否 | Integer | 时间间隔： 1:最近一周 2：最近一月 3：最近3月月 |
||
| status | 否 | Integer | 状态：0：未处理 1：已隔离 2：已信任 3：已删除 |
||
| severity | 否 | Integer | 危险等级： 1低危 2中危 3高危 4超危 5超高危 |
||
| agentGuid | 否 | String | 服务器详情病毒列表必填 | ||
| paramType | 否 | Integer | 参数类型： 1：服务器名称 2：服务器IP，配合parm查询使用 |
1 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 200-成功 | ||
| error | String | 返回码 CTCSSCN_000000：成功 CTCSSCN_000001：失败 CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用 CTCSSCN_000004：鉴权错误 CTCSSCN_000005：用户没有付费版配额，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回对象 | data |
表 data
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 总记录数 | 1 | |
| pageNum | Integer | 当前页码 | 1 | |
| pageSize | Integer | 每页大小 | 1 | |
| list | Array of Objects | 数据 | list |
表 list
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| custName | String | 主机名 | ||
| path | String | 文件路径 | ||
| agentGuid | String | agentguid | ||
| publicIp | String | 公网IP | ||
| agentIp | String | 私网IP | ||
| virusName | String | 病毒名称 | ||
| severity | Integer | 威胁等级： 1低危 2中危 3高危 4超危 5超高危 |
1 | |
| status | Integer | 检测状态： 1：检测成功 0：检测失败 |
1 | |
| findTime | Integer | 首次发现时间 | 2021-12-08 19:14:33 | |
| timestamp | String | 最近检测时间 | 2021-12-08 19:14:33 | |
| docId | String | 文档Id |
枚举参数
无
请求示例
请求url
无
请求头header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
请求体body
{"currentPage":1,"pageSize":10,"osType":1}
响应示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查询成功!","returnObj":{"total": 6,"list": [{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "70203BBB-80B7-42CB-962F-DE90D05A8279","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332687f79918b40b9f37134","path": "/root/dir1/file3.txt","virusName": "Eicar-Signature","severity": "3","status": 0},{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "0880B36D-45C5-438E-AC82-4F0A8B05B564","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332692e7d266507ddb239a8","path": "/root/dir1/file1.txt","virusName": "Eicar-Signature","severity": "3","status": 0},{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "0880B36D-45C5-438E-AC82-4F0A8B05B564","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332692e7d266507ddb239a9","path": "/root/dir1/file2.txt","virusName": "Eicar-Signature","severity": "3","status": 0},{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "70203BBB-80B7-42CB-962F-DE90D05A8279","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332687f79918b40b9f37133","path": "/root/dir1/file2.txt","virusName": "Eicar-Signature","severity": "3","status": 0},{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "70203BBB-80B7-42CB-962F-DE90D05A8279","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332687f79918b40b9f37132","path": "/root/dir1/file1.txt","virusName": "Eicar-Signature","severity": "3","status": 0},{"custName": null,"publicIp": null,"agentIp": null,"agentGuid": "0880B36D-45C5-438E-AC82-4F0A8B05B564","userName": null,"findTime": "2021-12-08 19:14:33","timestamp": "2021-12-08 19:14:33","docId": "6332692e7d266507ddb239aa","path": "/root/dir1/file3.txt","virusName": "Eicar-Signature","severity": "3","status": 0}],"pageNum": 1,"pageSize": 10,"size": 0,"startRow": 0,"endRow": 0,"pages": 1,"prePage": 0,"nextPage": 0,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": false,"hasNextPage": false,"navigatePages": 0,"navigatepageNums": null,"navigateFirstPage": 0,"navigateLastPage": 0}}
状态码
请参考 状态码
错误码
请参考 错误码
