获取敏感数据识别结果Top10命中规则 - ListHitRules
功能介绍
根据指定的任务ID和项目ID，获取敏感数据识别结果中Top10命中规则的信息，包括规则ID、名称、命中次数和敏感信息对象名称。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/scan-jobs/{job_id}/hit-rules
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID，用于标识具体的项目。 |
job_id | 是 | String | 敏感数据识别任务ID，用于标识具体的任务。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
offset | 否 | Integer | 页码，用于分页查询，默认值为0。 |
limit | 否 | Integer | 分页大小，用于限制每页返回的结果数量，默认值为100。 |
keyword | 否 | String | 敏感信息对象名称关键字，用于模糊查询。 |
asset_type | 否 | String | 资源类型，用于过滤结果。 |
asset_id | 否 | String | 资产ID，用于过滤结果。 |
security_level_ids | 否 | Array of strings | 风险等级ID数组，用于过滤结果。 |
marker | 否 | Array of strings | 上一批/下一批信息，用于分页查询。 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
total | Integer | 统计命中规则总数，表示所有命中规则对象的总数。 |
hit_rule_list | Array of ClassificationHitInfo objects | 命中规则列表，包含每个规则的详细统计信息。 |
参数 | 参数类型 | 描述 |
|---|---|---|
rule_id | String | 规则ID，用于唯一标识该规则（若使用LLM模板进行扫描，其返回结果信息中rule_id内容与rule_name一致）。 |
rule_name | String | 规则名称，用于标识和管理规则。 |
count | Integer | 命中对象的个数。 |
top_objects | Array of strings | 命中对象列表，表示该规则匹配到的敏感对象列表。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码，用于唯一标识具体的错误类型。 |
error_msg | String | 错误信息，对错误的详细描述。 |
请求示例
获取敏感数据识别结果Top10命中规则
GET /v1/{project_id}/scan-jobs/{job_id}/hit-rules 响应示例
状态码：200
请求成功，返回Top10命中规则信息。
{
"hit_rule_list" : [ {
"rule_id" : "xxxxxxxxxxxx",
"rule_name" : "xxxxxxxxxxxx",
"count" : 5,
"top_objects" : [ "xxxx", "xxxxxxx" ]
} ],
"total" : 1
} 状态码：400
无效请求，参数格式或内容不符合要求。
{
"error_code" : "dsc.40000011",
"error_msg" : "Invalid parameter"
} 状态码
状态码 | 描述 |
|---|---|
200 | 请求成功，返回Top10命中规则信息。 |
400 | 无效请求，参数格式或内容不符合要求。 |
错误码
请参见错误码。
