CreateTargetScanTask - AI Red Teaming 创建目标扫描任务
对已通过连通性验证的扫描目标发起安全扫描任务,创建成功后任务异步准备与执行
接口说明
请确保在使用该接口前,已充分了解 AI Red Teaming 产品的收费方式和价格。
对指定扫描目标发起一次安全扫描(AI Red Teaming 检测)任务。
调用前置条件:
账号售卖状态正常,否则返回 403;
TargetId 存在且归属当前租户;
目标连通性验证状态为 verified(可先调用 TestConnectivity 验证),否则返回 400;
当前扫描范围内存在可用攻击样本,否则返回 400。
执行模式:
调用同步返回 TaskId,任务初始状态为 PREPARING;样本准备与扫描执行异步进行,可通过 ListScanTasksByTarget 查询任务状态与进度。
选样说明:
样本范围按目标类型(agent/model)加通用样本确定;SampleLevel 决定检测强度并派生手法等级;Lang 用于样本语言过滤。
未指定样本意图时,系统按上述范围自动推导全部可用意图。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。