AddVirusScanAdditionalLists - 添加病毒扫描黑白名单

更新时间:
复制 MD 格式

向指定操作系统的病毒扫描黑白名单批量追加条目,不会覆盖已有条目。配额按匹配维度与名单类型的每个组合独立计算,每个组合下白名单最多10000条、黑名单最多1000条,追加后超出配额时整批失败。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

DevType

string

是

名单生效的操作系统类型。取值:

  • windows:Windows 系统。

  • macOS:macOS 系统。

枚举值:

  • windows :

    Windows 系统

  • macOS :

    macOS 系统

windows

AdditionalLists

array<object>

否

待追加的名单条目列表,至少包含 1 个。

object

否

名单条目。

AdditionalType

string

否

名单条目的匹配维度。取值:

  • FileSuffix:按文件扩展名匹配。

  • FileName:按文件名匹配。

  • FolderName:按文件夹名匹配。

  • FilePath:按文件路径匹配。

  • FileMd5:按文件 MD5 值匹配。

枚举值:

  • FileSuffix :

    按文件扩展名匹配

  • FilePath :

    按文件路径匹配

  • FileMd5 :

    按文件 MD5 值匹配

  • FileName :

    按文件名匹配

  • FolderName :

    按文件夹名匹配

FileSuffix

ListType

string

否

名单类型。取值:

  • Blacklist:黑名单,命中的文件直接判定为病毒文件。

  • Whitelist:白名单,命中的文件不参与病毒检测。

枚举值:

  • Whitelist :

    白名单

  • Blacklist :

    黑名单

Whitelist

Detail

string

否

名单条目内容,长度不超过 255 个字符。含义由 AdditionalType 决定:AdditionalType 取值为 FileSuffix 时填写文件扩展名,取值为 FileName 时填写文件名,取值为 FolderName 时填写文件夹名,取值为 FilePath 时填写文件路径,取值为 FileMd5 时填写文件的 MD5 值。

.tmp

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的 ID。

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

ListIds

array

本次新增的名单条目 ID 列表,顺序与请求中的 AdditionalLists 一致。

string

名单条目 ID。

additional-list-4d7b1e9a6c38****

示例

正常返回示例

JSON格式

{
  "RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
  "ListIds": [
    "additional-list-4d7b1e9a6c38****"
  ]
}

错误码

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

变更历史

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