调用ListUserPermissions展示指定用户所具备的库表权限。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListUserPermissions

要执行的操作，取值：ListUserPermissions。

PermType String 是 DATABASE

资源权限类型，取值和说明请参考ListDatabaseUserPermssions API。

Tid Long 是 -1

租户ID。

说明 取自系统右上角头像处悬停展示的租户ID信息，详情请参见查看租户信息。
UserId String 是 13435

用户ID，对应 GetUser API里面的用户ID，注意不是用户的阿里云Uid。
DatabaseName String 否 db_name

数据库名。
Logic Boolean 否 false

是否逻辑库，取值：

  • true
  • false
EnvType String 否 dev

库所属环境类型。
DbType String 否 MySQL

数据库类型。
PageNumber Integer 否 1

第几页。
PageSize Integer 否 1

每页数据量。

返回数据

名称 类型 示例值 描述
ErrorCode String UnknownError

错误码。
ErrorMessage String UnknownError

错误信息。
RequestId String C51420E3-144A-4A94-B473-8662FCF4AD10

请求ID。
Success Boolean true

请求是否成功。
TotalCount Long 6

满足条件记录总数。
UserPermissions Array of UserPermission

用户权限信息列表。
UserPermission
Alias String instance_alias

实例别名。
ColumnName String column_name

字段名。
DbId String 1324

库ID。
DbType String mysql

数据库类型。
DsType String DATABASE

权限资源类型。
EnvType String dev

数据库所属环境类型。
InstanceId String 134

实例ID。
Logic Boolean false

是否逻辑库，取值：

  • true
  • false
PermDetails Array of PermDetail

权限详情。
PermDetail
CreateDate String 2019-12-12 00:00:00

权限授予时间
ExpireDate String 2020-12-12 00:00:00

授权到期时间
ExtraData String xxx

额外数据，预留参数
OriginFrom String xxx

权限授予来源信息
PermType String QUERY

权限类型
UserAccessId String 1345

授权记录ID
SchemaName String test_db

数据库名。
SearchName String test_db@xxx:3306

库搜索名。
TableId String 13434

表ID。
TableName String test_table

表名。
UserId String 423245

用户ID。
UserNickName String nick_name

用户名。

示例

请求示例

http(s)://[Endpoint]/?Action=ListUserPermissions
&PermType=DATABASE
&Tid=-1
&UserId=13435
&<公共请求参数>

正常返回示例

XML 格式 

<UserPermissions>
    <UserPermission>
        <Logic>false</Logic>
        <UserNickName>xxx</UserNickName>
        <DsType>DATABASE</DsType>
        <Alias>xxx_ent_dev</Alias>
        <PermDetails>
            <PermDetail>
                <ExpireDate>2020-10-31 00:00:00</ExpireDate>
                <UserAccessId>390913</UserAccessId>
                <PermType>EXPORT</PermType>
                <OriginFrom>xxx</OriginFrom>
                <CreateDate>2019-11-21 15:07:45</CreateDate>
            </PermDetail>
            <PermDetail>
                <ExpireDate>2020-10-31 00:00:00</ExpireDate>
                <UserAccessId>390914</UserAccessId>
                <PermType>CORRECT</PermType>
                <OriginFrom>xxx</OriginFrom>
                <CreateDate>2019-11-21 15:07:45</CreateDate>
            </PermDetail>
        </PermDetails>
        <InstanceId>24671</InstanceId>
        <SearchName>xxx@xxx:3306</SearchName>
        <DbId>111369</DbId>
        <UserId>88658</UserId>
        <DbType>drds</DbType>
        <EnvType>dev</EnvType>
        <SchemaName>xxx_ent_dev</SchemaName>
    </UserPermission>
</UserPermissions>
<TotalCount>6</TotalCount>
<RequestId>C51420E3-144A-4A94-B473-8662FCF4AD10</RequestId>
<Success>true</Success>

JSON 格式 

{
  "UserPermissions": {
    "UserPermission": [
      {
        "Logic": false,
        "UserNickName": "xxx",
        "DsType": "DATABASE",
        "Alias": "xxx_ent_dev",
        "PermDetails": {
          "PermDetail": [
            {
              "ExpireDate": "2020-10-31 00:00:00",
              "UserAccessId": "390913",
              "PermType": "EXPORT",
              "OriginFrom": "xxx",
              "CreateDate": "2019-11-21 15:07:45"
            },
            {
              "ExpireDate": "2020-10-31 00:00:00",
              "UserAccessId": "390914",
              "PermType": "CORRECT",
              "OriginFrom": "xxx",
              "CreateDate": "2019-11-21 15:07:45"
            }
          ]
        },
        "InstanceId": 24671,
        "SearchName": "xxx@xxx:3306",
        "DbId": 111369,
        "UserId": 88658,
        "DbType": "drds",
        "EnvType": "dev",
        "SchemaName": "xxx_ent_dev"
      }
    ]
  },
  "TotalCount": 6,
  "RequestId": "C51420E3-144A-4A94-B473-8662FCF4AD10",
  "Success": true
}

错误码

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