CreateTargetScanTask - AI Red Teaming 创建目标扫描任务

更新时间:
复制 MD 格式

对已通过连通性验证的扫描目标发起安全扫描任务,创建成功后任务异步准备与执行

接口说明

请确保在使用该接口前,已充分了解 AI Red Teaming 产品的收费方式和价格。

对指定扫描目标发起一次安全扫描(AI Red Teaming 检测)任务。

调用前置条件:

  • 账号售卖状态正常,否则返回 403;

  • TargetId 存在且归属当前租户;

  • 目标连通性验证状态为 verified(可先调用 TestConnectivity 验证),否则返回 400;

  • 当前扫描范围内存在可用攻击样本,否则返回 400。

执行模式:

  • 调用同步返回 TaskId,任务初始状态为 PREPARING;样本准备与扫描执行异步进行,可通过 ListScanTasksByTarget 查询任务状态与进度。

选样说明:

  • 样本范围按目标类型(agent/model)加通用样本确定;SampleLevel 决定检测强度并派生手法等级;Lang 用于样本语言过滤。

  • 未指定样本意图时,系统按上述范围自动推导全部可用意图。

调试

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

调试

授权信息

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

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

TargetId

string

是

扫描目标的唯一标识。目标必须已通过连通性验证(verifyStatus=verified),否则返回 400;可先调用 TestConnectivity 完成验证。

target-abc123def4567

SampleLevel

integer

否

检测强度,后端按此派生对应的手法等级;不传时依次回退到目标已保存的扫描任务配置与系统默认值。

3

Lang

string

否

样本语言过滤,locale 格式(如 zh_CN、en_US,内部归一为 zh、en);不传时结合通用样本按默认语言策略选样。

zh_CN

返回参数

名称

类型

描述

示例值

object

Data

object

创建结果,返回新扫描任务的 TaskId。

TaskId

string

扫描任务的唯一标识。任务初始状态为 PREPARING(异步准备中),可通过 ListScanTasksByTarget 查询任务状态与进度。

task-abc123def4567

RequestId

string

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

1EBD0C05-6C1F-4C95-9C63-XXXXX

示例

正常返回示例

JSON格式

{
  "Data": {
    "TaskId": "task-abc123def4567"
  },
  "RequestId": "1EBD0C05-6C1F-4C95-9C63-XXXXX"
}

错误码

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

变更历史

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