AI 助理
文档备案控制台
官方文档
首页 智能体安全中心 开发参考 API参考（Agent安全中心） API目录 ListScanTasksByTarget - AI Red Teaming 查询目标扫描任务列表

ListScanTasksByTarget - AI Red Teaming 查询目标扫描任务列表

更新时间：
复制 MD 格式
我的收藏

AI Red Teaming，分页查询指定扫描目标下的扫描任务，支持按检测强度、任务状态与扫描模式过滤

接口说明

分页查询指定扫描目标下的扫描任务列表，仅返回归属当前租户的目标的任务。

查询范围与排序：

  • 仅返回最近 366 天内创建的任务；

  • 按创建时间倒序排列；

  • TaskStatus 按任务状态过滤；ScanType 按扫描模式过滤（扫描模式存于任务执行参数，历史未记录扫描模式的任务按 attack 处理）。

分页规则：

  • PageNumber 从 1 开始，小于 1 时归一为 1；

  • PageSize 默认 10，单页上限 100；大于 100 时钳制为 100，小于 1 时返回 400；

  • 响应中的 PageNumber 与 PageSize 为归一化后的实际生效值。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-aisc:ListScanTasksByTarget

get

*全部资源

*

 无 无

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值
TargetId

string

是

扫描目标的唯一标识，仅查询该目标下的任务；目标不存在或不归属当前租户时返回 400。

target-abc123def4567
PageSize

string

是

每页条数，默认 10，单页上限 100；大于 100 时钳制为 100，小于 1 时返回 400。

10
PageNumber

string

是

页码，从 1 开始；小于 1 时归一为 1。

1
SampleLevel

string

否

按检测强度过滤；不传则不按强度过滤。

枚举值：

  • 1 :

    快速

  • 2 :

    标准

  • 3 :

    深度

2
TaskStatus

string

否

按任务状态过滤；不传返回全部状态。

枚举值：

  • running :

    处理中

  • canceled :

    取消

  • preparing :

    样本准备中

  • report_generating :

    报告生成中

  • pending :

    等待中

  • completed :

    已完成

  • failed :

    执行失败

  • timeout :

    执行超时

completed
ScanType

string

否

按扫描模式过滤；不传返回全部模式。

枚举值：

  • attack :

    安全攻防扫描

  • tc260 :

    TC260 备案扫描

attack

返回参数

名称

类型

描述

示例值

object

Data

array<object>

当前页的扫描任务列表。

object

CreateTime

integer

任务创建时间，毫秒时间戳（Unix epoch 毫秒）。

1735689600000
EndTime

integer

任务结束时间，毫秒时间戳（Unix epoch 毫秒）；任务未结束时为 null。

1735689600000
ExecuteCaseCount

integer

任务已执行的样本数量。

80
ReportLanguage

string

报告语言

枚举值：

  • ms :

    ms

  • en :

    en

  • zh :

    zh

zh
RiskLevel

string

任务结果的风险等级；任务未完成或未产生风险评定时为 null。

枚举值：

  • high :

    高风险

  • low :

    低风险

  • medium :

    中风险

high
SampleLanguage

string

样本语言

枚举值：

  • ms :

    ms

  • en :

    en

  • zh :

    zh

zh
SampleLevel

integer

任务的检测强度。

枚举值：

  • 1 :

    快速

  • 2 :

    标准

  • 3 :

    深度

2
ScanType

string

任务的扫描模式；历史未记录扫描模式的任务归一为 attack。

枚举值：

  • attack :

    安全攻防扫描

  • tc260 :

    TC260 备案扫描

attack
ScannerTaskId

string

扫描任务的唯一标识，可用于结果下载与状态跟踪。

task-abc123def4567
ScannerTaskMessage

string

任务消息；失败时为失败原因，成功或无消息时为空。

执行超时
ScannerTaskStatus

string

任务的当前状态。

枚举值：

  • running :

    处理中

  • canceled :

    取消

  • preparing :

    样本准备中

  • report_generating :

    报告生成中

  • pending :

    等待中

  • completed :

    已完成

  • failed :

    执行失败

  • timeout :

    执行超时

completed
StartTime

integer

任务开始时间，毫秒时间戳（Unix epoch 毫秒）；任务未开始时为 null。

1735689600000
TaskName

string

任务名称；创建时未指定则默认为"Target Scan - 目标名称"。

Target Scan - 我的百炼靶标
TotalCaseCount

integer

任务计划执行的样本总数。

120
PageNumber

integer

归一化后的实际生效页码，不一定等于入参。

1
PageSize

integer

归一化后的实际生效每页条数，不一定等于入参。

10
RequestId

string

本次请求的唯一标识，用于问题排查与日志追踪。

1EBD0C05-6C1F-4C95-9C63-B7AB7B5A9C8E
TotalCount

integer

满足过滤条件的扫描任务总数（最近 366 天窗口内）。

42

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "CreateTime": 1735689600000,
      "EndTime": 1735689600000,
      "ExecuteCaseCount": 80,
      "ReportLanguage": "zh",
      "RiskLevel": "high",
      "SampleLanguage": "zh",
      "SampleLevel": 2,
      "ScanType": "attack",
      "ScannerTaskId": "task-abc123def4567",
      "ScannerTaskMessage": "执行超时",
      "ScannerTaskStatus": "completed",
      "StartTime": 1735689600000,
      "TaskName": "Target Scan - 我的百炼靶标",
      "TotalCaseCount": 120
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "1EBD0C05-6C1F-4C95-9C63-B7AB7B5A9C8E",
  "TotalCount": 42
}

错误码

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

变更历史

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

上一篇：ListAttackTargets - AI Red Teaming 获取扫描对象列表下一篇：StopScannerTask - AI Red Teaming 停止扫描任务