病毒查殺列表接口
更新時間 2025-07-09 15:33:51
最近更新時間: 2025-07-09 15:33:51
分享文章
接口功能介紹
病毒查殺-病毒查殺列表接口。
接口約束
此功能為收費功能。確認已經購買服務器配額，并且開啟服務器防護。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護。
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}}
狀態碼
請參考
錯誤碼
請參考
