AI 助理
文档备案控制台
官方文档
首页 办公安全平台 开发参考 API参考 API目录 终端安全 防病毒 ListVirusScanTasks - 批量查询病毒扫描任务

ListVirusScanTasks - 批量查询病毒扫描任务

更新时间：
复制 MD 格式
产品详情
我的收藏

分页查询当前阿里云账号下的即时病毒扫描任务。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
CurrentPage

integer

是

分页查询时显示的当前页的页码。取值：1~10000。

1
PageSize

integer

是

分页查询时设置的每页数量。取值：1~1000。

10
ScanModes

array

否

扫描的路径范围集合，不允许重复。

string

否

扫描的路径范围。取值：

  • Quick：快速扫描。

  • Full：全盘扫描。

  • Custom：自定义路径扫描。

枚举值：

  • Quick :

    快速扫描

  • Custom :

    自定义路径扫描

  • Full :

    全盘扫描

Full
PerformanceModes

array

否

扫描性能模式集合，不允许重复。

string

否

扫描性能模式。取值：

  • SecurityFirst：安全优先。

  • Balance：均衡。

  • ExperienceFirst：体验优先。

枚举值：

  • SecurityFirst :

    安全优先

  • Balance :

    均衡

  • ExperienceFirst :

    体验优先

Balance
TaskIds

array

否

病毒扫描任务 ID 集合，不允许重复。

string

否

病毒扫描任务 ID。取值来源：

v1:1024772
UserGroupId

string

否

用户组 ID，用于筛选生效范围包含该用户组的任务。取值来源：

usergroup-9d4f2a7b3c1e****
Status

integer

否

任务状态。取值：

  • 0：未取消，默认值。

  • 1：已取消。

  • -1：不按状态过滤，返回全部任务。

枚举值：

  • 0 :

    未取消

  • 1 :

    已取消

  • -1 :

    不按状态过滤

0
EndTime

integer

否

任务失效时间的筛选终点，秒级 Unix 时间戳。必须大于 StartTime。

1762135466
StartTime

integer

否

任务失效时间的筛选起点，秒级 Unix 时间戳。必须与 EndTime 一同传入，单独传入不生效。

1754150421

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的 ID。

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

integer

病毒扫描任务总数。

100
Tasks

array<object>

病毒扫描任务列表。

array<object>

病毒扫描任务。

TaskId

string

病毒扫描任务 ID。

v1:1024772
TaskDescription

string

任务描述。

研发部门全盘扫描
ScanTargets

array

本次扫描要处置的病毒类型集合。

string

病毒类型。取值：

  • Backdoor：后门程序。

  • DDoS：DDoS 木马。

  • Downloader：下载器木马。

  • Engtest：引擎测试程序。

  • Hacktool：黑客工具。

  • Trojan：自变异木马。

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

  • MalScript：恶意脚本。

  • Malware：恶意程序。

  • Miner：挖矿程序。

  • Proxytool：代理工具。

  • RansomWare：勒索病毒。

  • RiskWare：风险软件。

  • Rootkit：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
ScanMode

string

扫描的路径范围。取值：

  • Quick：快速扫描，仅扫描系统关键目录与常见风险位置。

  • Full：全盘扫描。

  • Custom：自定义路径扫描。

枚举值：

  • Quick :

    快速扫描

  • Custom :

    自定义扫描

  • Full :

    全盘扫描

Quick
ScanPath

array

自定义扫描路径集合。

string

自定义扫描路径。

C:\\test2
PerformanceMode

string

扫描性能模式。取值：

  • SecurityFirst：安全优先，CPU 占用上限默认为 50%。

  • Balance：均衡，CPU 占用上限默认为 30%。

  • ExperienceFirst：体验优先，CPU 占用上限默认为 15%。

枚举值：

  • SecurityFirst :

    安全优先

  • Balance :

    均衡

  • ExperienceFirst :

    体验优先

Balance
HighRiskOperation

string

对高危病毒文件的处置动作。取值：

  • Quarantine：隔离文件。

  • Notify：仅上报告警，不处置文件。

枚举值：

  • Notify :

    仅上报告警

  • Quarantine :

    隔离

Quarantine
MidRiskOperation

string

对中危病毒文件的处置动作。取值：

  • Quarantine：隔离文件。

  • Notify：仅上报告警，不处置文件。

枚举值：

  • Notify :

    仅上报告警

  • Quarantine :

    隔离

Notify
LowRiskOperation

string

对低危病毒文件的处置动作。取值：

  • Quarantine：隔离文件。

  • Notify：仅上报告警，不处置文件。

  • None：不处理。

枚举值：

  • Notify :

    仅上报告警

  • Quarantine :

    隔离

  • None :

    不处理

None
MatchMode

string

生效范围的匹配方式。取值：

  • UserGroupAll：对当前阿里云账号下的全部用户生效。

  • UserGroupNormal：仅对指定用户组内的用户生效。

枚举值：

  • UserGroupNormal :

    部分用户组生效

  • UserGroupAll :

    全员生效

UserGroupNormal
CreateTime

string

任务创建时间，格式为 yyyy-MM-dd HH:mm:ss，使用 UTC+8 时区。

2026-08-21 10:24:31
EndTime

integer

任务失效时间，秒级 Unix 时间戳。

1786377600
Whitelist

array

例外用户名单。

string

用户名。

王先生
MatchTargetInfos

array<object>

生效的用户组集合。

object

用户组。

TargetId

string

用户组 ID。

usergroup-9d4f2a7b3c1e****
TargetName

string

用户组名称。

研发部门
Status

integer

任务状态。取值：

  • 0：未取消。

  • 1：已取消。

枚举值：

  • 0 :

    未取消

  • 1 :

    已取消

0
CustomMatchGroup

array<object>

按组织架构指定的生效范围。

object

组织架构生效范围。

IdpId

string

身份源 ID。

idp-7c3f9a2e5b18****
Group

array

组织架构节点集合。

string

组织架构节点的 DN。

OU=研发部,OU=SASE
MaxCpuUsage

integer

扫描时占用终端 CPU 的百分比上限。

30

示例

正常返回示例

JSON格式

{
  "RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
  "TotalNum": 100,
  "Tasks": [
    {
      "TaskId": "v1:1024772",
      "TaskDescription": "研发部门全盘扫描",
      "ScanTargets": [
        "Virus"
      ],
      "ScanMode": "Quick",
      "ScanPath": [
        "C:\\\\test2"
      ],
      "PerformanceMode": "Balance",
      "HighRiskOperation": "Quarantine",
      "MidRiskOperation": "Notify",
      "LowRiskOperation": "None",
      "MatchMode": "UserGroupNormal",
      "CreateTime": "2026-08-21 10:24:31",
      "EndTime": 1786377600,
      "Whitelist": [
        "王先生"
      ],
      "MatchTargetInfos": [
        {
          "TargetId": "usergroup-9d4f2a7b3c1e****",
          "TargetName": "研发部门"
        }
      ],
      "Status": 0,
      "CustomMatchGroup": [
        {
          "IdpId": "idp-7c3f9a2e5b18****",
          "Group": [
            "OU=研发部,OU=SASE"
          ]
        }
      ],
      "MaxCpuUsage": 30
    }
  ]
}

错误码

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

变更历史

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

上一篇：RemoveVirusScanAdditionalLists - 移除病毒扫描黑白名单下一篇：ListVirusScanTaskSummary - 批量查询病毒扫描任务检出统计