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