查询数据安全中心连接授权的MaxCompute、RDS等数据资产的表数据。

接口说明

在调用 DescribeTables 接口时，您可以设置搜索关键词、数据资产表的风险等级等参数来获取符合要求的数据资产的表信息。

QPS 限制

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

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sddp:DescribeTables	Read	acs:yundun-sddp::{#accountId}:*	无	无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	请求和接收消息的语言类型，默认为zh_cn。取值： zh_cn：中文。 en_us：英文。	zh_cn
Name	string	否	搜索的关键词，支持模糊匹配。例如，输入 test，会搜索出搜索项中包含 test 的全部数据信息。	test
ProductId	long	否	数据资产表所属产品 ID。该产品 ID 可调用 DescribeDataAssets 接口获取。	1
ProductCode	string	否	数据资产表所属产品名称，包括 MaxCompute、OSS、RDS 等。关于支持的产品名称，请参见支持识别敏感数据的数据类型。	MaxCompute
RiskLevelId	long	否	数据资产表的风险等级 ID。每个风险等级 ID 都有对应的风险等级名称。取值： 1：N/A：未识别到敏感数据。 2：S1：1 级敏感数据。 3：S2：2 级敏感数据。 4：S3：3 级敏感数据。 5：S4：4 级敏感数据。	2
RuleId	long	否	数据资产表命中的敏感数据识别规则 ID。该敏感数据识别规则 ID 可调用 DescribeRules 接口获取。	333322
InstanceId	long	否	数据资产表所属的资产实例 ID。该资产实例 ID 可调用 DescribeInstances 接口获取。	1
PackageId	long	否	数据资产表所属的资产包 ID。该资产包 ID 可调用 DescribePackages 接口获取。	555555
PageSize	integer	否	列表中每页显示的数据最大条数。默认值：10。	10
CurrentPage	integer	否	分页查询时的页码。默认值：1。	1
ServiceRegionId	string	否	支持数据安全中心服务的地域。更多信息，请参见支持的地域。	cn-hangzhou
TemplateId	long	否	行业模版 ID	1

返回参数

名称	类型	描述	示例值
	object
CurrentPage	integer	结果中显示的当前页的页码。	1
RequestId	string	结果的请求 ID。	769FB3C1-F4C9-42DF-9B72-7077A8989C13
PageSize	integer	结果中每页显示的数据条数。	10
TotalCount	integer	结果中数据的总条数。	13
Items	object []	数据资产表的信息列表。
CreationTime	long	创建该数据资产表的时间。单位：毫秒。	1536751124000
Owner	string	拥有该数据资产表的阿里云账号。	dtdep-239-******
SensitiveRatio	string	数据资产表中敏感字段所占的百分比。	21%
TenantName	string	租户名称。	租户1
RiskLevelId	long	数据资产表的风险等级 ID。每个风险等级 ID 都有对应的风险等级名称。取值： 1：N/A：未识别到敏感数据。 2：S1：1 级敏感数据。 3：S2：2 级敏感数据。 4：S3：3 级敏感数据。 5：S4：4 级敏感数据。	2
InstanceName	string	数据资产表的实例名称。	实例1
ProductId	string	数据资产表所属的产品 ID。	1
Name	string	数据资产表的名称。	gxdata
InstanceId	long	数据资产表所属的资产实例 ID。	1
TotalCount	integer	数据资产表包含的字段总数。	1234
InstanceDescription	string	实例的备注信息。	备注1
Sensitive	boolean	数据资产表中是否包含敏感字段。 true：包含。 false：不包含。	true
RiskLevelName	string	数据资产表的风险等级名称。取值： N/A：未识别到敏感数据。 S1：1 级敏感数据。 S2：2 级敏感数据。 S3：3 级敏感数据。 S4：4 级敏感数据。	S2
SensitiveCount	integer	数据资产表中包含的敏感字段总数。	32
Id	long	数据资产表的唯一标识 ID。	222
ProductCode	string	数据资产表所属产品名称，取值：MaxCompute、OSS、ADS、OTS、RDS等。关于支持的具体产品名称，请参见支持识别敏感数据的数据类型。	MaxCompute
RuleList	object []	数据资产表命中的敏感数据识别规则信息。
Name	string	规则的名称。	规则名称
RiskLevelId	long	敏感数据识别规则的风险等级 ID。取值： 1：N/A：未识别到敏感数据。 2：S1：1 级敏感数据。 3：S2：2 级敏感数据。 4：S3：3 级敏感数据。 5：S4：4 级敏感数据。	1
Count	long	规则的总数。	12

示例

正常返回示例

JSON格式

{
  "CurrentPage": 1,
  "RequestId": "769FB3C1-F4C9-42DF-9B72-7077A8989C13",
  "PageSize": 10,
  "TotalCount": 13,
  "Items": [
    {
      "CreationTime": 1536751124000,
      "Owner": "dtdep-239-******",
      "SensitiveRatio": "21%",
      "TenantName": "租户1",
      "RiskLevelId": 2,
      "InstanceName": "实例1",
      "ProductId": "1",
      "Name": "gxdata",
      "InstanceId": 1,
      "TotalCount": 1234,
      "InstanceDescription": "备注1",
      "Sensitive": true,
      "RiskLevelName": "S2",
      "SensitiveCount": 32,
      "Id": 222,
      "ProductCode": "MaxCompute",
      "RuleList": [
        {
          "Name": "规则名称",
          "RiskLevelId": 1,
          "Count": 12
        }
      ]
    }
  ]
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-12-06

API 内部配置变更，不影响调用