# 获取敏感数据识别结果Top10命中规则 - ListHitRules
#### 功能介绍
根据指定的任务ID和项目ID，获取敏感数据识别结果中Top10命中规则的信息，包括规则ID、名称、命中次数和敏感信息对象名称。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/scan-jobs/{job_id}/hit-rules
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                    |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，用于标识具体的项目。       |
| job_id     | 是    | String | 敏感数据识别任务ID，用于标识具体的任务。 |
   
表2Query参数 
| 参数                 | 是否必选 | 参数类型             | 描述                          |
|:---|:---|:---|:---|
| 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**
表3响应Body参数 
| 参数            | 参数类型                                                                                    | 描述                      |
|:---|:---|:---|
| total         | Integer                                                                                 | 统计命中规则总数，表示所有命中规则对象的总数。 |
| hit_rule_list | Array of [ClassificationHitInfo] objects | 命中规则列表，包含每个规则的详细统计信息。   |
   
 表4ClassificationHitInfo 
| 参数          | 参数类型             | 描述                                                          |
|:---|:---|:---|
| rule_id     | String           | 规则ID，用于唯一标识该规则（若使用LLM模板进行扫描，其返回结果信息中rule_id内容与rule_name一致）。 |
| rule_name   | String           | 规则名称，用于标识和管理规则。                                             |
| count       | Integer          | 命中对象的个数。                                                    |
| top_objects | Array of strings | 命中对象列表，表示该规则匹配到的敏感对象列表。                                     |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                 |
|:---|:---|:---|
| 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 | 无效请求，参数格式或内容不符合要求。  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。