GetScannerTaskHitDataUrl - AI Red Teaming 获取扫描任务命中数据下载链接
AI Red Teaming 获取扫描任务攻击成功数据(hits.csv)的临时下载链接,链接有效期 2 小时,数据未生成时返回空字符串
接口说明
获取指定扫描任务的攻击成功数据(hits.csv)临时下载链接。
ScannerTaskId 实际必填:空值返回 400;
仅能查询归属当前租户的任务;任务不存在或归属其他租户时统一返回 400,不暴露资源是否存在;
下载链接为对象存储签名临时链接,有效期 2 小时(7200 秒),过期后需重新调用本接口获取新链接;
攻击成功数据尚未生成(存量任务,或 agent 执行模式未产出命中数据)时,响应中的下载链接为空字符串,不返回错误;
本接口为只读 Action(Get 前缀),只读权限的 RAM 子账号即可调用;行为与已废弃的 GenerateScannerTaskHitDataUrl 一致。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。