调用DescribeAccountPrivileges查询数据库账号的权限_云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

获取给定数据库账号在某个级别拥有的权限。

接口说明

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

调试

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

调试

授权信息

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

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

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

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
DBClusterId	string	是	企业版、基础版或湖仓版的集群 ID。	amv-bp1k5p066e1a****
AccountName	string	是	要查看权限的数据库账号名称。	account1
PrivilegeType	string	否	要查看的权限级别，来自接口`DescribeEnabledPrivileges`。	Global
DatabasePrivilegeObject	string	否	根据数据库名称进行筛选。只有当权限级别为库、表、列时才可用。	db1
TablePrivilegeObject	string	否	根据表名称进行筛选。可以和库名称一起进行联合筛选，只有当权限级别是表和列时该参数才可用。	table1
PageNumber	string	否	页号，从 1 开始，默认值 1。	1
PageSize	string	否	每页含有的条目数量，默认每页 20 条。	10
ColumnPrivilegeObject	string	否	根据列名称进行筛选，只有当权限级别是列时该参数才可用。	col1

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	DA32480A-E3E5-1BE7-BA98-724551DC04C8
Data	array<object>	权限详情列表。
data	object	权限详情。
PrivilegeType	string	权限级别，可以是全局`Global`、库`Databae`、表`Table`和列`Column`，来自接口`DescribeEnabledPrivileges`。	Column
PrivilegeObject	object	权限对象，为库表列的三元组，以及额外的描述信息。
Database	string	数据库名称。	db1
Table	string	表名称。	tabl1
Column	string	列名称。	column1
Description	string	描述信息。	a test column
Privileges	array	权限列表。
privilege	string	权限名，来自接口`DescribeEnabledPrivileges`。	insert,select
TotalCount	long	用户在该权限级别拥有的权限总数。	100
PageNumber	long	页号，和入参的页号一致。	1
PageSize	long	页大小，和入参的页大小一致。	20

示例

正常返回示例

JSON格式

{
  "RequestId": "DA32480A-E3E5-1BE7-BA98-724551DC04C8",
  "Data": [
    {
      "PrivilegeType": "Column",
      "PrivilegeObject": {
        "Database": "db1",
        "Table": "tabl1",
        "Column": "column1",
        "Description": "a test column"
      },
      "Privileges": [
        "insert,select"
      ]
    }
  ],
  "TotalCount": 100,
  "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 内部配置变更，不影响调用	查看变更详情