文档首页/ 数据安全中心 DSC/ API参考/ API说明/ 敏感数据识别/ 获取敏感数据分级列表
更新时间：2025-09-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取敏感数据分级列表

功能介绍

获取敏感数据分级列表，支持分页查询和过滤。

调用方法

请参见如何调用API。

URI

GET /v1/{project_id}/scan-security-levels

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，用于标识具体的项目。
表2 Query参数

参数

是否必选

参数类型

描述

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

风险等级列表，包含每个风险等级的详细信息。
表4 SecurityLevel

参数

参数类型

描述

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

无效请求，参数格式或内容不符合要求。

错误码

请参见错误码。

父主题： 敏感数据识别

相关文档