调用ListUserPermissions展示指定用户所具备的库表权限。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dms:ListUserPermissions |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Tid |
integer |
否 |
租户 ID。 说明
鼠标移动到界面右上角的头像处,查看租户 ID。具体操作,请参见查看租户信息。 |
3*** |
| PermType |
string |
是 |
资源权限类型,取值如下:
|
DATABASE |
| UserId |
string |
是 |
用户 ID,可通过调用接口 GetUser 或 ListUsers 获取该参数的值。 说明
用户 ID 不是用户的阿里云 Uid。 |
51**** |
| DatabaseName |
string |
否 |
数据库名。 |
db_name |
| SearchKey |
string |
否 |
搜索关键词。例如,搜索实例权限,此处可填入 DMS 中的实例地址,如:rm-bp144d5ky4l4r****。 |
rm-bp144d5ky4l4r**** |
| Logic |
boolean |
否 |
是否逻辑库,取值:
|
false |
| EnvType |
string |
否 |
环境类型,取值如下:
|
dev |
| DbType |
string |
否 |
数据库类型,取值请参见 DbType 参数说明。 |
polardb |
| PageNumber |
integer |
否 |
第几页。 |
1 |
| PageSize |
integer |
否 |
每页数据量。 |
5 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TotalCount |
integer |
满足条件记录总数。 |
1 |
| RequestId |
string |
请求 ID。 |
C51420E3-144A-4A94-B473-8662FCF4AD10 |
| ErrorCode |
string |
错误码。 |
UnknownError |
| ErrorMessage |
string |
错误信息。 |
UnknownError |
| UserPermissions |
object |
||
| UserPermission |
array<object> |
用户权限信息列表。 |
|
|
array<object> |
|||
| DbId |
string |
库 ID。 |
1860**** |
| TableName |
string |
表名。 |
test_table |
| UserId |
string |
用户 ID。 |
51**** |
| SchemaName |
string |
数据库名。 |
test_db |
| Logic |
boolean |
是否逻辑库,取值:
|
false |
| UserNickName |
string |
用户名。 |
nick_name |
| InstanceId |
string |
实例 ID。 |
174**** |
| PermDetails |
object |
||
| PermDetail |
array<object> |
权限详情。 |
|
|
object |
权限详情 |
||
| OriginFrom |
string |
权限授予来源信息。 |
xxx授权 |
| PermType |
string |
权限类型,返回值如下:
|
QUERY |
| ExpireDate |
string |
授权到期时间。 |
2020-12-12 00:00:00 |
| CreateDate |
string |
权限授予时间。 |
2019-12-12 00:00:00 |
| UserAccessId |
string |
授权记录 ID。 |
758**** |
| ExtraData |
string |
额外数据,预留参数。 |
xxx |
| EnvType |
string |
数据库所属环境类型,返回值如下:
|
dev |
| ColumnName |
string |
字段名。 |
column_name |
| DbType |
string |
数据库类型,返回值请参见 DbType 参数说明。 |
polardb |
| DsType |
string |
权限类型,取值如下:
|
DATABASE |
| TableId |
string |
表 ID。 |
13434 |
| SearchName |
string |
库搜索名。 |
test_db@xxx:3306 |
| Alias |
string |
实例别名。 |
instance_alias |
| Host |
string |
实例地址。 |
rm-bp144d5ky4l4r**** |
| Port |
integer |
实例端口。 |
3306 |
| Success |
boolean |
请求是否成功,返回值如下:
|
true |
示例
正常返回示例
JSON格式
{
"TotalCount": 1,
"RequestId": "C51420E3-144A-4A94-B473-8662FCF4AD10",
"ErrorCode": "UnknownError",
"ErrorMessage": "UnknownError",
"UserPermissions": {
"UserPermission": [
{
"DbId": "1860****",
"TableName": "test_table",
"UserId": "51****",
"SchemaName": "test_db",
"Logic": false,
"UserNickName": "nick_name",
"InstanceId": "174****",
"PermDetails": {
"PermDetail": [
{
"OriginFrom": "xxx授权",
"PermType": "QUERY",
"ExpireDate": "2020-12-12 00:00:00",
"CreateDate": "2019-12-12 00:00:00",
"UserAccessId": "758****",
"ExtraData": "xxx"
}
]
},
"EnvType": "dev",
"ColumnName": "column_name",
"DbType": "polardb",
"DsType": "DATABASE",
"TableId": "13434",
"SearchName": "test_db@xxx:3306",
"Alias": "instance_alias",
"Host": "rm-bp144d5ky4l4r****",
"Port": 3306
}
]
},
"Success": true
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。