# 获取敏感数据分级列表 - ShowSecurityLevel
#### 功能介绍
获取敏感数据分级列表，支持分页查询和过滤。
#### 调用方法
请参见[如何调用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-security-levels
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述              |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，用于标识具体的项目。 |
   
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                           |
|:---|:---|:---|:---|
| offset     | 否    | Integer | 页码，用于分页查询，默认值为0。             |
| limit      | 否    | Integer | 分页大小，用于限制每页返回的结果数量，默认值为100。  |
| name       | 否    | String  | 级别名称，用于模糊查询。                 |
| category   | 否    | String  | 级别来源，用于过滤结果。                 |
| is_deleted | 否    | Boolean | true：查询所有分级；false：查询未被禁用的分级。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                   | 参数类型                                                                         | 描述                    |
|:---|:---|:---|
| total                | Integer                                                                      | 风险等级总数，表示风险等级的总数。     |
| security_levels_list | Array of [SecurityLevel] objects | 风险等级列表，包含每个风险等级的详细信息。 |
   
 表4SecurityLevel 
| 参数                  | 参数类型    | 描述                                                                   |
|:---|:---|:---|
| level_id            | String  | 风险等级ID，用于唯一标识该风险等级。                                                  |
| project_id          | String  | 项目ID，用于标识具体的项目。                                                      |
| security_level_name | String  | 风险等级名称，表示该风险等级的名称。                                                   |
| color_number        | Integer | 风险等级颜色，用于在界面中显示风险等级的颜色标识。                                            |
| security_level_desc | String  | 风险等级描述，对风险等级的详细说明。                                                   |
| used_count          | Integer | 关联的识别模板个数，表示该风险等级被使用的模板数量。                                           |
| category            | String  | 规则创建类型，用于区分内置规则（BUILT_IN）、内置规则副本（BUILT_IN_COPY）和用户自定义规则（BUILT_SELF）。 |
| create_time         | Long    | 规则创建时间，表示该风险等级的创建时间戳。                                                |
| update_time         | Long    | 规则更新时间，表示该风险等级的最后更新时间戳。                                              |
| sort_weight         | Integer | 规则排序位置，用于在列表中对风险等级进行排序。                                              |
| is_deleted          | Boolean | 规则是否禁用，表示该风险等级是否被禁用。                                                 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                 |
|:---|:---|:---|
| error_code | String | 错误码，用于唯一标识具体的错误类型。 |
| error_msg  | String | 错误信息，对错误的详细描述。     |
   
#### 请求示例
获取敏感数据分级列表
```
GET /v1/{project_id}/scan-security-levels
```
#### 响应示例
**状态码：200**
请求成功，返回敏感数据识别分级列表。
```
{
  "security_levels_list" : [ {
    "level_id" : "xxxxxxxxxxxx",
    "project_id" : "xxxxxxxxxxxx",
    "security_level_name" : "L4",
    "color_number" : 4,
    "security_level_desc" : "xxxxx",
    "used_count" : 4,
    "category" : "BUILT_SELF",
    "create_time" : 1710560820120,
    "update_time" : 1710573345350,
    "sort_weight" : 21,
    "is_deleted" : false
  } ],
  "total" : 1
}
```
**状态码：400**
无效请求，参数格式或内容不符合要求。
```
{
  "error_code" : "dsc.40000011",
  "error_msg" : "Invalid parameter"
}
```
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | 请求成功，返回敏感数据识别分级列表。 |
| 400 | 无效请求，参数格式或内容不符合要求。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。