文档首页/ 数据安全中心 DSC/ API参考/ API说明/ 敏感数据识别/ 获取敏感数据识别分类分级结果详情
更新时间:2025-08-01 GMT+08:00
分享

获取敏感数据识别分类分级结果详情

功能介绍

根据指定的任务ID和项目ID,获取敏感数据识别分类分级结果详情,支持分页查询和关键字过滤。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/scan-jobs/{job_id}/classification-results

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,用于标识具体的项目。

job_id

String

敏感数据识别任务ID,用于标识具体的扫描任务。

表2 Query参数

参数

是否必选

参数类型

描述

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

识别结果总数,表示所有识别结果的总数。

classification_list

Array of ClassificationResultsEntity objects

识别结果对象列表,包含每个识别结果的详细信息。

marker

Array of objects

分批结果,用于分页查询时标识当前批次的结束位置。

表4 ClassificationResultsEntity

参数

参数类型

描述

id

String

结果标记,用于唯一标识该识别结果。

project_id

String

项目ID,用于标识具体的项目。

job_id

String

任务ID,用于标识具体的任务。

task_id

String

子任务ID,用于标识具体的子任务。

ins_id

String

实例ID,用于标识具体的实例。

asset_id

String

资产ID,用于标识具体的资产。

asset_name

String

资产名称,用于标识和管理资产。

asset_type

String

资产类型,表示资产的类型,如OBS、DATABASE、BIGDATA等。

object_name

String

对象名称,表示资产中的具体对象名称。

object_full_path

String

对象全路径,表示资产中对象的完整路径。

security_level_name

String

识别结果等级名称,表示该资产的风险等级名称。

security_level_id

String

识别结果等级ID,表示该资产的风险等级ID。

security_level_color

Integer

识别结果等级颜色,用于在界面中显示风险等级的颜色标识。

create_time

Long

创建时间,表示该识别结果的创建时间戳。

update_time

Long

更新时间,表示该识别结果的最后更新时间戳。

scan_time

Long

识别时间,表示该识别结果的开始识别时间。

match_info

Array of ClassificationMatchInfo objects

匹配规则列表,表示该资产中所有匹配到的规则及其详细信息。

表5 ClassificationMatchInfo

参数

参数类型

描述

template_id

String

识别模板ID,用于唯一标识该模板。

template_name

String

识别模板名称,用于标识和管理模板。

rule_id

String

规则ID,用于唯一标识该规则。

rule_name

String

规则名称,用于标识和管理规则。

security_level_name

String

识别结果等级名称,表示该规则识别出的风险等级名称。

security_level_id

String

识别结果等级ID,表示该规则识别出的风险等级ID。

security_level_color

Integer

识别结果等级颜色,用于在界面中显示风险等级的颜色标识。

classification_name

String

分类分级名称,表示该规则所属的分类名称。

classification_id

String

分类分级ID,表示该规则所属的分类ID。

matched_detail

String

匹配明细,表示该规则匹配到的具体内容和位置。

matched_examples

Array of MatchedExamples objects

匹配规则列表,表示该规则匹配到的具体内容示例。

表6 MatchedExamples

参数

参数类型

描述

line_number

Long

行数,表示匹配内容在文件中的具体位置。

matched_content

String

规则内容,表示匹配到的具体内容。

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码,用于唯一标识具体的错误类型。

error_msg

String

错误信息,对错误的详细描述。

请求示例

获取敏感数据识别分类分级结果详情

GET /v1/{project_id}/scan-jobs/{job_id}/classification-results

响应示例

状态码:200

请求成功,返回分类结果列表。

{
  "classification_list" : [ {
    "id" : "xxxxxxxxxxxx",
    "project_id" : "xxxxxxxxxxxx",
    "job_id" : "xxxxxxxxxxxx",
    "task_id" : "xxxxxxxxxxxx",
    "ins_id" : "xxxxxxxxxxxx",
    "asset_id" : "xxxxxxxxxxxx",
    "asset_name" : "xxxxxxxxxxxx",
    "asset_type" : "OBS",
    "object_name" : "xxxxxxxxxxxx",
    "object_full_path" : "xxxxxxxxxxxx",
    "security_level_name" : "L4",
    "security_level_id" : "xxxxxxxxxxxx",
    "security_level_color" : 4,
    "create_time" : 1710560820120,
    "update_time" : 1710573345350,
    "scan_time" : 12293,
    "match_info" : [ {
      "template_id" : "xxxxxxxxxxxx",
      "template_name" : "xxxxxxxxxxxx",
      "rule_id" : "xxxxxxxxxxxx",
      "rule_name" : "xxxxx",
      "security_level_name" : "L4",
      "security_level_id" : "xxxxxxxxxxxx",
      "security_level_color" : 5,
      "classification_name" : "xxxxxxxxxxxx",
      "classification_id" : "xxxxxxxxxxxx",
      "matched_detail" : "xxx"
    } ]
  } ],
  "total" : 1,
  "marker" : [ { }, { } ]
}

状态码:400

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

{
  "error_code" : "dsc.40000011",
  "error_msg" : "Invalid parameter"
}

状态码

状态码

描述

200

请求成功,返回分类结果列表。

400

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

错误码

请参见错误码

相关文档