UpdateVirusFileStatus - 修改病毒文件处置状态

更新时间:
复制 MD 格式

对指定用户终端设备上的病毒文件执行隔离或信任处置。DevTag、FilePath与FileMd5三者共同定位一条病毒文件记录,记录不存在时调用失败。隔离为异步操作,服务端创建处置任务后由用户终端设备拉取执行。同一条病毒文件记录1分钟内只允许处置一次。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

DevTag

string

是

病毒文件所在用户终端设备的唯一标识。长度不超过 64 个字符。取值来源:

36efa42d-2c32-c4dc-e3fc-8541e33a****

FilePath

string

是

病毒文件在用户终端设备上的绝对路径。取值来源:

C:\Users\Public\Downloads\setup.exe

FileMd5

string

是

病毒文件的 MD5 值,必须为 32 位十六进制字符。取值来源:

d41d8cd98f00b204e9800998ecf8427e

Operation

string

是

处置动作。取值:

  • AdminQuarantine:隔离该病毒文件。服务端创建处置任务并返回 TaskId,由用户终端设备拉取后执行隔离。

  • AdminTrust:信任该病毒文件。仅更新处置状态,不创建处置任务,TaskId 返回空字符串。

枚举值:

  • AdminTrust :

    信任

  • AdminQuarantine :

    隔离

AdminQuarantine

VirusType

string

否

病毒类型,用于同步更新该文件的病毒类型。取值:

  • Backdoor:后门程序。

  • DDoS:DDoS 木马。

  • Downloader:下载器木马。

  • Engtest:引擎测试程序。

  • Hacktool:黑客工具。

  • Trojan:自变异木马。

  • Malbaseware:被污染的基础软件。

  • MalScript:恶意脚本。

  • Malware:恶意程序。

  • Miner:挖矿程序。

  • Proxytool:代理工具。

  • RansomWare:勒索病毒。

  • RiskWare:风险软件。

  • Rootkit:内核隐藏程序。

  • Stealer:窃密工具。

  • Scanner:扫描器。

  • Suspicious:可疑程序。

  • Virus:感染型病毒。

  • WebShell:网站后门。

  • Worm:蠕虫病毒。

  • BlackList:命中黑名单的文件。

  • Exp:漏洞利用程序。

  • Patcher:破解程序。

  • Gametool:私服工具。

  • AdWare:广告程序。

  • Maldoc:恶意文档。

枚举值:

  • Scanner :

    扫描器

  • Hacktool :

    黑客工具

  • WebShell :

    网站后门

  • Proxytool :

    代理工具

  • Stealer :

    窃密工具

  • Downloader :

    下载器木马

  • BlackList :

    黑名单的文件

  • RiskWare :

    风险软件

  • Worm :

    蠕虫病毒

  • DDoS :

    DDoS 木马

  • Patcher :

    破解程序

  • Gametool :

    私服工具

  • Maldoc :

    恶意文档

  • Rootkit :

    内核隐藏程序

  • MalScript :

    恶意脚本

  • Virus :

    感染型病毒

  • Miner :

    挖矿程序

  • Engtest :

    引擎测试程序

  • Suspicious :

    可疑程序

  • AdWare :

    广告程序

  • Malbaseware :

    被污染的基础软件

  • Trojan :

    木马

  • Backdoor :

    后门程序

  • RansomWare :

    勒索病毒

  • Exp :

    漏洞利用程序

Virus

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的 ID。

3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7

TaskId

string

处置任务 ID。Operation 取值为 AdminQuarantine 时返回,取值为 AdminTrust 时返回空字符串。可通过 ListVirusFileStatuses 的 TaskExecutionInfo 查看用户终端设备的执行结果。

v1:1024773

示例

正常返回示例

JSON格式

{
  "RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
  "TaskId": "v1:1024773"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。