GetSensitiveScanResult - 查询敏感信息扫描结果

Updated at:

查询敏感信息扫描任务的状态和结果,返回扫描发现的敏感数据详情。

接口说明

请求说明

  • 调用本接口查询通过 CreateSensitiveScanTask 创建的敏感信息扫描任务的执行状态和结果。
  • 建议以 3~5 秒的间隔轮询,直到任务状态变为 completed 或 terminated。
  • ClientToken 参数用于保证请求的幂等性,由客户端生成且在不同请求间唯一,支持 ASCII 字符,长度不超过 64 个字符。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
aideepsign:GetSensitiveScanResultget
*全部资源
*
    无
无

请求参数

名称类型必填描述示例值
TaskIdstring是

任务 ID,由 CreateSensitiveScanTask 返回。

f47ac10b-58cc-4372-a567-0e02b2c3d479

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

A1B2C3D4-E5F6-7890-ABCD-EF1234567890
Statusstring

任务状态。取值:running(执行中)、completed(已完成)、terminated(终止/失败)。

completed
Resultobject

扫描结果(仅 completed 状态返回)

OssObjectDetailobject

扫描对象名称。

Namestring

扫描对象名称。

abc12345.jpg
BucketNamestring

所属 Bucket 名称。

aideepsign-bucket
RiskLevelNamestring

整体风险等级名称。

S2
CategoryNamestring

敏感数据分类名称。

个人信息
RuleListarray<object>

命中的敏感数据规则列表。

Ruleobject
CategoryNamestring

规则所属分类名称。

个人信息
RuleNamestring

规则名称。

身份证号
Countinteger

命中次数。

1
RiskLevelNamestring

该规则的风险等级名称。

S2
Successboolean

请求是否成功。

Messagestring

附加信息。请求成功时返回 "success"。

success
HttpStatusCodeinteger

HTTP 状态码。请求成功时返回 200。

200
Codestring

业务错误码。请求成功时返回 "OK"。

OK

示例

正常返回示例

JSON格式

{
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "Status": "completed",
  "Result": {
    "OssObjectDetail": {
      "Name": "abc12345.jpg",
      "BucketName": "aideepsign-bucket",
      "RiskLevelName": "S2",
      "CategoryName": "个人信息",
      "RuleList": [
        {
          "CategoryName": "个人信息",
          "RuleName": "身份证号",
          "Count": 1,
          "RiskLevelName": "S2"
        }
      ]
    }
  },
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

错误码

HTTP status code错误码错误信息
400IdempotentParameterMismatchThe request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

变更历史

变更时间变更内容概要操作
2026-06-29新增 OpenAPI查看变更详情