查询指定操作系统下的病毒扫描黑白名单，按匹配维度与名单类型分组返回。黑白名单是阿里云账号与操作系统维度的全局名单，对该账号下的即时扫描、定时扫描与实时防御全部生效。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DevType |
string |
是 |
名单生效的操作系统类型。取值：
枚举值：
|
windows |
| AdditionalTypes |
array |
否 |
按匹配维度过滤，不允许重复。不传则返回全部匹配维度。 |
|
|
string |
否 |
名单条目的匹配维度。取值：
枚举值：
|
FileSuffix |
|
| ListType |
string |
否 |
按名单类型过滤。不传则黑名单与白名单都返回。取值：
枚举值：
|
Whitelist |
| ListIds |
array |
否 |
按名单条目 ID 过滤，不允许重复。不传则不按名单条目 ID 过滤。 |
|
|
string |
否 |
名单条目 ID。取值来源：
|
additional-list-4d7b1e9a6c38**** |
|
| ListDetail |
string |
否 |
名单条目内容，精确匹配。用于按内容定位某一条名单，不支持模糊查询。 |
.tmp |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次请求的 ID。 |
3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7 |
| AdditionalLists |
array<object> |
按匹配维度分组的黑白名单列表。某一匹配维度下没有任何名单条目时，该维度不会出现在列表中。 |
|
|
array<object> |
某一匹配维度下的黑白名单。 |
||
| AdditionalType |
string |
名单条目的匹配维度。取值：
枚举值：
|
FileSuffix |
| Lists |
array<object> |
该匹配维度下按名单类型分组的名单。 |
|
|
array<object> |
某一名单类型下的名单。 |
||
| ListType |
string |
名单类型。取值：
枚举值：
|
Whitelist |
| ListDetail |
array<object> |
名单条目列表。 |
|
|
object |
名单条目。 |
||
| ListId |
string |
名单条目 ID。 |
additional-list-4d7b1e9a6c38**** |
| Detail |
string |
名单条目内容，含义由所属的 AdditionalType 决定。 |
.tmp |
| CreateTime |
string |
名单条目的创建时间，格式为 yyyy-MM-dd HH:mm:ss，使用 UTC+8 时区。 |
2026-08-21 10:24:31 |
示例
正常返回示例
JSON格式
{
"RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
"AdditionalLists": [
{
"AdditionalType": "FileSuffix",
"Lists": [
{
"ListType": "Whitelist",
"ListDetail": [
{
"ListId": "additional-list-4d7b1e9a6c38****",
"Detail": ".tmp",
"CreateTime": "2026-08-21 10:24:31"
}
]
}
]
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。