调用DescribeDataAssets查询数据资产敏感信息_数据安全中心(DSC)-阿里云帮助中心

执行敏感数据保护概览页面的数据资产搜索。

接口说明

本接口一般用于敏感数据保护概览页面各资产类型数据的查询。

注意事项

此接口已废弃，不再维护。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用将会被限流，这可能影响您的业务，请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sddp:DescribeDataAssets	get	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	指定请求和接收消息的语言类型，默认为zh_cn。取值： zh_cn：中文（简体） en_us：英文（美国）	zh_cn
Name	string	否	指定要查询资产的关键词，支持模糊查询。	test
RiskLevels	string	否	指定要查询的数据资产的风险等级，存在多个时使用英文逗号（,）隔开。 2：S1，弱风险等级 3：S2，中等风险等级 4：S3，高风险等级 5：S4，最高风险等级	2
RuleId	long	否	指定数据资产命中的敏感数据识别规则唯一标识 ID。说明如果根据数据资产命中的敏感数据识别规则来搜索数据资产，敏感数据识别规则的 ID 可调用 DescribeRules 接口获取。	11122200
RangeId	integer	否	指定要查询的数据资产类型。取值： 1：MaxCompute 项目 2：MaxCompute 表 3：MaxCompute 包 11：分析型数据库 MySQL（ADS）库 12：分析型数据库 MySQL（ADS）表 21：OSS 文件桶 22：OSS Object 31：表格存储实例 32：表格存储表 51：RDS 库 52：RDS 表 61：ECS 自建数据库 62：ECS 自建数据表 71：DRDS 库 72：DRDS 表 81：PolarDB 库 82：PolarDB 表 91：GPDB 库 92：GPDB 表	1
PageSize	integer	否	指定分页查询时，每页显示的数据最大条数。默认值：20。	20
CurrentPage	integer	否	指定分页查询时，当前页的页码。	1

返回参数

名称	类型	描述	示例值
	object
CurrentPage	integer	分页查询时，当前页的页码。	1
RequestId	string	阿里云为该请求生成的唯一标识符。	71064826-726F-4ADA-B879-05D8055476FB
PageSize	integer	分页查询时，每页最多显示的数据条数。	20
TotalCount	integer	查询到的存在敏感数据的资产总数量。	1
Items	array<object>	数据资产列表。
Asset	object
Acl	string	OSS 文件桶的 ACL 权限设置。说明只有您将请求参数 RangeId 配置为 21，即要查询的数据资产为 OSS 文件桶时，该参数才会显示。	private
CreationTime	long	数据资产创建时间，单位为毫秒。	1536751124000
DataType	string	数据资产所属的数据类型。	OSS_BUCKET
Owner	string	数据资产所属者账号。	dtdep-239-******
SensitiveRatio	string	在所有数据资产中敏感数据所占的比例。	45%
Protection	boolean	数据资产的防护状态，固定值：false。只有您将请求参数 RangeId 配置为 1，即要查询的数据资产为 MaxCompute 项目时，该参数才会返回 true 或 false。 false: 未开启数据保护机制。 true：开启数据保护机制。项目空间中的数据只能流入，不能流出。	false
Labelsec	boolean	数据的敏感度标记，固定值：0。只有您将请求参数 RangeId 配置为 1，即要查询的数据资产为 MaxCompute 项目时，该参数才会返回 0、1、2 或 3。 0：不保密，Unclassified 1：秘密，Confidential 2：机密，Sensitive 3 ：高度机密，Highly Sensitive	0
TotalCount	integer	所有数据资产的数量。例如：MaxCompute 中项目、包或表的总数；RDS 中数据库或表的总数；OSS 中文件桶或 Object 的总数。	432
RiskLevelId	long	数据资产的风险等级 ID。风险等级 ID 越高，表示识别出的数据越敏感。取值： 1：未识别到敏感数据，无风险 2：1 级敏感数据风险 3：2 级敏感数据风险 4：3 级敏感数据风险 5：4 级敏感数据风险 6：5 级敏感数据风险 7：6 级敏感数据风险 8：7 级敏感数据风险 9：8 级敏感数据风险 10：9 级敏感数据风险 11：10 级敏感数据风险	2
RuleName	string	数据资产命中的敏感数据识别规则名称。	***规则
Sensitive	boolean	数据资产中是否包含敏感数据。取值： true：包含 false：不包含	true
ObjectKey	string	OSS 存储对象的 Key 值。说明只有您将请求参数 RangeId 配置为 22，即要查询的数据资产为 OSS Object 时，该参数才会显示。	内部
RiskLevelName	string	数据资产的风险等级名称。	中等风险等级
OdpsRiskLevelName	string	MaxCompute 资产的风险等级名称。取值： S1：弱风险等级 S2：中等风险等级 S3：高级风险等级 S4：最高风险等级说明只有您将请求参数 RangeId 配置为 1，即要查询的数据资产为 MaxCompute 项目时，该参数才会显示。	S4
ProductId	string	数据资产所属产品类型 ID。取值： 1：MaxCompute 2：OSS 3：ADS 4：OTS 5：RDS	5
Name	string	数据资产名称。	gxdata
SensitiveCount	integer	数据资产中敏感数据总数。例如：MaxCompute 中敏感的项目、包或表的总数；RDS 中敏感的数据库或表的总数；OSS 中敏感的文件桶或 Object 的总数。	24
Id	string	数据资产的唯一标识 ID。	268
ProductCode	string	数据资产所属产品名称。	RDS

示例

正常返回示例

JSON格式

{
  "CurrentPage": 1,
  "RequestId": "71064826-726F-4ADA-B879-05D8055476FB",
  "PageSize": 20,
  "TotalCount": 1,
  "Items": [
    {
      "Acl": "private",
      "CreationTime": 1536751124000,
      "DataType": "OSS_BUCKET",
      "Owner": "dtdep-239-******",
      "SensitiveRatio": "45%",
      "Protection": false,
      "Labelsec": true,
      "TotalCount": 432,
      "RiskLevelId": 2,
      "RuleName": "***规则",
      "Sensitive": true,
      "ObjectKey": "内部",
      "RiskLevelName": "中等风险等级",
      "OdpsRiskLevelName": "S4",
      "ProductId": "5",
      "Name": "gxdata",
      "SensitiveCount": 24,
      "Id": "268",
      "ProductCode": "RDS"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史