ListAttackTargets - AI Red Teaming 获取扫描对象列表

更新时间:
复制 MD 格式

AI Red Teaming,获取扫描目标列表,支持多维度筛选和排序

调试

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

调试

授权信息

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

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

PageNumber

integer

是

页码,从 1 开始;小于 1 时归一为 1。

1

PageSize

integer

是

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

10

TargetName

string

否

按目标名称模糊过滤(包含子串即命中),不传返回全部。

百炼

Provider

string

否

按模型/Agent 提供商业务标签精确过滤;与 ConnectionMethod(技术协议)解耦。

枚举值:

  • agentkit :

    AgentKit 平台

  • openai :

    OpenAI 服务

  • dify :

    Dify 平台

  • bailian :

    阿里云百炼

  • agentrun :

    AgentRun 平台

  • custom :

    其他或自研

  • anthropic :

    Anthropic 服务

  • pai :

    阿里云 PAI

  • openclaw :

    OpenClaw 平台

bailian

LastScanStatus

string

否

按最近一次扫描任务的检测状态过滤。

枚举值:

  • running :

    扫描中

  • never :

    从未扫描

  • completed :

    扫描完成

  • failed :

    扫描失败

completed

TargetType

string

否

按扫描目标类型精确过滤。

枚举值:

  • agent :

    智能体(Agent)

  • model :

    模型

model

RiskLevel

string

否

按最近一次已完成扫描任务派生的风险等级过滤;从未扫描的目标无风险等级,不会被任何取值命中。

枚举值:

  • high :

    高风险

  • low :

    低风险

  • medium :

    中风险

high

SortField

string

否

排序字段,仅支持以下三个聚合字段,排序在内存中完成;不传则不额外排序。

枚举值:

  • lastScanTime :

    最后扫描时间

  • firstScanTime :

    首次扫描时间

  • scanCount :

    累计扫描次数

lastScanTime

SortOrder

string

否

排序方向;聚合值为空的目标无论方向都排在最后。

枚举值:

  • asc :

    升序

  • desc :

    降序

desc

FirstScanTimeStart

string

否

首次扫描时间范围下界(含),毫秒时间戳(Unix epoch 毫秒)。

1735689600000

FirstScanTimeEnd

string

否

首次扫描时间范围上界(含),毫秒时间戳(Unix epoch 毫秒)。

1735689600000

LastScanTimeStart

string

否

最后扫描时间范围下界(含),毫秒时间戳(Unix epoch 毫秒)。

1735689600000

LastScanTimeEnd

string

否

最后扫描时间范围上界(含),毫秒时间戳(Unix epoch 毫秒)。

1735689600000

返回参数

名称

类型

描述

示例值

object

Data

array<object>

当前页的扫描目标列表。

object

ConnectionConfig

string

目标连接高级配置(JSON 字符串),常见字段与 provider 配置模板参见 CreateAttackTarget 的 ConnectionConfig 参数说明。

{\"httpMethod\":\"POST\",\"authType\":\"bearer\",\"timeoutMs\":30000,\"requestTemplate\":\"{\\\"input\\\":{\\\"prompt\\\":\\\"{{prompt}}\\\"},\\\"parameters\\\":{\\\"incremental_output\\\":true},\\\"debug\\\":{}}\",\"messageJsonPath\":\"$.output.text\",\"requestHeaders\":\"{\\\"X-DashScope-SSE\\\": \\\"enable\\\" }\",\"stream\":true,\"customAuthHeaderName\":\"\"}

ConnectionMethod

string

目标服务的连接协议类型。

枚举值:

  • enterprise_relay :

    企业内网 Agent 接入(轮询拉取模式)

  • openai :

    OpenAI 兼容协议

  • anthropic :

    Anthropic Messages API 协议

openai

CreateTime

integer

目标创建时间,毫秒时间戳(Unix epoch 毫秒)。

1735689600000

Description

string

扫描目标的用途备注说明。

生产环境百炼应用

Endpoint

string

目标模型服务的 HTTP/HTTPS 端点地址。

https://dashscope.aliyuncs.com/compatible-mode/v1

FirstScanTime

integer

首次扫描时间,毫秒时间戳(Unix epoch 毫秒);从未扫描时为 null。

1735689600000

LastScanFailMessage

string

最近一次扫描任务的失败原因;最近一次扫描未失败时为空。

扫描执行器连接超时

LastScanStatus

string

最近一次扫描任务的检测状态。

枚举值:

  • running :

    扫描中

  • never :

    从未扫描

  • completed :

    扫描完成

  • failed :

    扫描失败

completed

LastScanTime

integer

最后扫描时间,毫秒时间戳(Unix epoch 毫秒);从未扫描时为 null。

1735689600000

LastVerifyMessage

string

最近一次连通性验证的详细消息;验证通过时为目标服务返回的响应内容片段,失败时为错误原因。

连通性验证成功

ModelName

string

目标模型的名称。

qwen-flash

ModifyTime

integer

目标最后修改时间,毫秒时间戳(Unix epoch 毫秒)。

1735689600000

Provider

string

模型/Agent 提供商业务标签。

枚举值:

  • agentkit :

    AgentKit 平台

  • openai :

    OpenAI 服务

  • dify :

    Dify 平台

  • bailian :

    阿里云百炼

  • agentrun :

    AgentRun 平台

  • custom :

    其他或自研

  • anthropic :

    Anthropic 服务

  • pai :

    阿里云 PAI

  • openclaw :

    OpenClaw 平台

bailian

RiskLevel

string

最近一次已完成扫描任务派生的风险等级;从未扫描时为 null。

枚举值:

  • high :

    高风险

  • low :

    低风险

  • medium :

    中风险

high

ScanCount

integer

累计扫描次数;从未扫描时为 0。

12

TargetId

string

扫描目标的唯一标识。

target-abc123def4567

TargetName

string

扫描目标的展示名称。

我的百炼靶标

TargetType

string

扫描目标的类型。

枚举值:

  • agent :

    智能体(Agent)

  • model :

    模型

model

VerifyStatus

string

目标的连通性验证状态。

枚举值:

  • verified :

    连通性验证通过

  • failed :

    连通性验证失败

verified

PageNumber

integer

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

1

PageSize

integer

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

10

RequestId

string

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

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

TotalCount

integer

满足过滤条件的扫描目标总数;后置过滤场景为内存过滤后的总数。

42

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "ConnectionConfig": "{\\\"httpMethod\\\":\\\"POST\\\",\\\"authType\\\":\\\"bearer\\\",\\\"timeoutMs\\\":30000,\\\"requestTemplate\\\":\\\"{\\\\\\\"input\\\\\\\":{\\\\\\\"prompt\\\\\\\":\\\\\\\"{{prompt}}\\\\\\\"},\\\\\\\"parameters\\\\\\\":{\\\\\\\"incremental_output\\\\\\\":true},\\\\\\\"debug\\\\\\\":{}}\\\",\\\"messageJsonPath\\\":\\\"$.output.text\\\",\\\"requestHeaders\\\":\\\"{\\\\\\\"X-DashScope-SSE\\\\\\\": \\\\\\\"enable\\\\\\\" }\\\",\\\"stream\\\":true,\\\"customAuthHeaderName\\\":\\\"\\\"}",
      "ConnectionMethod": "openai",
      "CreateTime": 1735689600000,
      "Description": "生产环境百炼应用",
      "Endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "FirstScanTime": 1735689600000,
      "LastScanFailMessage": "扫描执行器连接超时",
      "LastScanStatus": "completed",
      "LastScanTime": 1735689600000,
      "LastVerifyMessage": "连通性验证成功",
      "ModelName": "qwen-flash",
      "ModifyTime": 1735689600000,
      "Provider": "bailian",
      "RiskLevel": "high",
      "ScanCount": 12,
      "TargetId": "target-abc123def4567",
      "TargetName": "我的百炼靶标",
      "TargetType": "model",
      "VerifyStatus": "verified"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "1EBD0C05-6C1F-4C95-9C63-xxxx",
  "TotalCount": 42
}

错误码

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

变更历史

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