GetScannerTaskHitDataUrl - AI Red Teaming 获取扫描任务命中数据下载链接

更新时间:
复制 MD 格式

AI Red Teaming 获取扫描任务攻击成功数据(hits.csv)的临时下载链接,链接有效期 2 小时,数据未生成时返回空字符串

接口说明

获取指定扫描任务的攻击成功数据(hits.csv)临时下载链接。

  • ScannerTaskId 实际必填:空值返回 400;

  • 仅能查询归属当前租户的任务;任务不存在或归属其他租户时统一返回 400,不暴露资源是否存在;

  • 下载链接为对象存储签名临时链接,有效期 2 小时(7200 秒),过期后需重新调用本接口获取新链接;

  • 攻击成功数据尚未生成(存量任务,或 agent 执行模式未产出命中数据)时,响应中的下载链接为空字符串,不返回错误;

  • 本接口为只读 Action(Get 前缀),只读权限的 RAM 子账号即可调用;行为与已废弃的 GenerateScannerTaskHitDataUrl 一致。

调试

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

调试

授权信息

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

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

ScannerTaskId

string

否

扫描任务的唯一标识(CreateTargetScanTask 返回的 TaskId,或 ListScanTasksByTarget 返回的 ScannerTaskId);登记为选填但实际必填,空值返回 400;任务不存在或归属其他租户时统一返回 400,不暴露资源是否存在。

task-abc123def4567

返回参数

名称

类型

描述

示例值

object

Schema of Response

Data

object

查询结果,包含任务标识与命中数据临时下载链接。

ScannerTaskHitDataDownloadUrl

string

攻击成功数据(hits.csv)的临时下载链接,有效期 2 小时,过期需重新调用本接口获取;存量任务或 agent 执行模式未产出命中数据时为空字符串。实际值为对象存储签名临时链接(含签名参数)。

https://example.com/result.task-abc123def4567.hits.csv

ScannerTaskId

string

请求中扫描任务标识的回显。

task-abc123def4567

RequestId

string

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

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

示例

正常返回示例

JSON格式

{
  "Data": {
    "ScannerTaskHitDataDownloadUrl": "https://example.com/result.task-abc123def4567.hits.csv",
    "ScannerTaskId": "task-abc123def4567"
  },
  "RequestId": "1EBD0C05-6C1F-4C95-9C63-B7AB7B5A9C8E"
}

错误码

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

变更历史

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