文档首页/ 数据安全中心 DSC/ API参考/ API/ 风险评估/ 查询数据保护类型 - ListDataProtectTypes
更新时间:2026-11-13 GMT+08:00
分享

查询数据保护类型 - ListDataProtectTypes

功能介绍

功能介绍:查询指定生命周期阶段下的数据保护类型列表(data-protect-types 别名路径),返回数据类型详细信息。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/data-protect-types

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

满足正则匹配"^[a-z0-9]{32}$",即32位小写字母和数字组合。

取值范围:

以IAM服务接口返回值为准,由数字和字母组成,长度为32个字符。

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

life_cycle

是

String

参数解释:

数据保护所处的数据生命周期阶段,用于指定数据所处的保护阶段

约束限制:

不涉及

取值范围:

  • COLLECTION-采集

  • TRANSMISSION-传输

  • STORAGE-存储

  • USAGE-使用

  • SHARING-共享

  • DESTRUCTION-销毁

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of DataTypeDetail objects

参数解释:

数据类型详情列表,数组中每个元素为一条数据类型详情

取值范围:

不涉及

表5 DataTypeDetail

参数

参数类型

描述

data_type

String

参数解释:

数据类型

取值范围:

  • NORMAL-一般数据

  • LEVEL-分级数据

  • CLASSIFICATION-分类数据

  • OTHER-其他数据

life_cycle

String

参数解释:

生命周期

取值范围:

  • COLLECTION-采集

  • TRANSMISSION-传输

  • STORAGE-存储

  • USAGE-使用

  • SHARING-共享

  • DESTRUCTION-销毁

data_type_id

String

参数解释:

数据类型ID,标识一种数据类型,可通过查询数据类型列表接口获取

取值范围:

不涉及

category

String

参数解释:

类别

取值范围:

  • BUILT_IN-内置

  • BUILT_IN_COPY-内置复制

  • BUILT_SELF-自建

id

Long

参数解释:

资源ID,唯一标识,可通过查询数据类型列表接口获取

取值范围:

不涉及

create_time

Long

参数解释:

创建时间,单位为毫秒(Unix时间戳),表示该数据类型记录的创建时间

取值范围:

不涉及

update_time

Long

参数解释:

更新时间,单位为毫秒(Unix时间戳),表示该数据类型记录的最后修改时间

取值范围:

不涉及

is_deleted

Boolean

参数解释:

是否已删除

取值范围:

true-是,false-否

请求示例

查询数据保护类型列表(data-protect-types 别名路径)

/v1/2b31ed520aabbccddeedb6e571234567/data-protect-types?life_cycle=STORAGE

响应示例

状态码:200

[ {
  "data_type" : "NORMAL",
  "life_cycle" : "STORAGE",
  "data_type_id" : "2001",
  "category" : "BUILT_IN",
  "id" : 2001,
  "create_time" : 1787306400000,
  "update_time" : 1787309400000,
  "is_deleted" : false
} ]

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

相关文档