调用DescribeAccountPrivilegeObjects查询数据库账号可见的库表列_云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

获取给定账号可见的库表列。

接口说明

当前服务的接入地址请参见服务接入点。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
adb:DescribeAccountPrivilegeObjects	list	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	ch-hangzhou
DBClusterId	string	是	企业版、基础版或湖仓版的集群 ID。	amv-bp1k3wdmt139****
AccountName	string	是	数据库账号名称。	test
PrivilegeType	string	否	权限级别，只能传入库（Database)）、表（Table）、列（Column）级别，不能传入全局（Global）级别。	Column
DatabasePrivilegeObject	string	否	根据给定的数据库名称进行筛选。	database1
TablePrivilegeObject	string	否	根据给定的表名称进行筛选。	table1
PageNumber	string	否	页号，从 1 开始，默认值 1。	1
PageSize	string	否	每页含有条目的最大数量，默认为 20。	20
ColumnPrivilegeObject	string	否	根据给定的列名进行筛选。	col1

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	34B2AD29-682F-1C14-B3AA-9EF1A96084B8
Data	array<object>	权限列表。
data	object	权限对象，为库、表、列的三元组。
Database	string	数据库名称，当权限级别是库、表、列时返回该字段。	tdb1
Table	string	表名称，当权限级别是表和列时返回该字段。	table1
Column	string	列名称，当权限界别是列时返回该字段。	column1
Description	string	创建表/列时指定的描述。只有当权限级别为库和表时才有值，分别代表库和表的描述。	a test db
TotalCount	long	查询得到的结果总数。	23
PageNumber	long	页号，和传入的值一致。	1
PageSize	long	页大小，和传入的值一致。	20

示例

正常返回示例

JSON格式

{
  "RequestId": "34B2AD29-682F-1C14-B3AA-9EF1A96084B8",
  "Data": [
    {
      "Database": "tdb1",
      "Table": "table1",
      "Column": "column1",
      "Description": "a test db"
    }
  ],
  "TotalCount": 23,
  "PageNumber": 1,
  "PageSize": 20
}

错误码

HTTP status code	错误码	错误信息	描述
400	ACS.Account.NotExist	The account is not found.	用户账户不存在。
400	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	DBClusterId参数不正确，请确认参数是否符合规范。
400	ACS.InvalidParameter.%s	Parameter %s is invalid.	输入的参数无效
400	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。
400	ACS.User.NotBindDatabaseAccount	The user has not been associated with a database account.	用户没有绑定数据库账户。

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

变更历史

变更时间	变更内容概要	操作
2023-12-06	OpenAPI 错误码发生变更	查看变更详情
2023-04-20	OpenAPI 错误码发生变更	查看变更详情
2023-03-24	API 内部配置变更，不影响调用	查看变更详情