对指定用户终端设备上的病毒文件执行隔离或信任处置。DevTag、FilePath与FileMd5三者共同定位一条病毒文件记录,记录不存在时调用失败。隔离为异步操作,服务端创建处置任务后由用户终端设备拉取执行。同一条病毒文件记录1分钟内只允许处置一次。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DevTag |
string |
是 |
病毒文件所在用户终端设备的唯一标识。长度不超过 64 个字符。取值来源:
|
36efa42d-2c32-c4dc-e3fc-8541e33a**** |
| FilePath |
string |
是 |
病毒文件在用户终端设备上的绝对路径。取值来源:
|
C:\Users\Public\Downloads\setup.exe |
| FileMd5 |
string |
是 |
病毒文件的 MD5 值,必须为 32 位十六进制字符。取值来源:
|
d41d8cd98f00b204e9800998ecf8427e |
| Operation |
string |
是 |
处置动作。取值:
枚举值:
|
AdminQuarantine |
| VirusType |
string |
否 |
病毒类型,用于同步更新该文件的病毒类型。取值:
枚举值:
|
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。