更新时间:2022-12-07 GMT+08:00

查看表的使用者

功能介绍

该API用于查看有权访问指定表或表的列的所有用户。

URI

  • URI格式:

    GET /v1.0/{project_id}/databases/{database_name}/tables/{table_name}/users

  • 参数说明
    表1 URI 参数

    参数名称

    是否必选

    说明

    project_id

    项目编号,用于资源隔离。获取方式请参考获取项目ID

    database_name

    被查询的表所在的数据库名称。

    table_name

    被查询的表名称。

请求消息

无请求参数。

响应消息

表2 响应参数

参数名称

是否必选

参数类型

说明

is_success

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

String

系统提示信息,执行成功时,信息可能为空。

privileges

Array <Objects>

权限信息。具体参数请参考表3

表3 privileges参数

参数名称

是否必选

参数类型

说明

is_admin

Boolean

判断是否为管理用户。

object

String

该用户有权限的对象:

  • “databases.数据库名.tables.表名”,用户在当前表上的权限。
  • “databases.数据库名.tables.表名.columns.列名”,用户在列上的权限。

privileges

Array<String>

该用户在相应object上的权限。

user_name

String

拥有该权限的用户名。

请求示例

响应示例

{
  "is_success": true,
  "message": "",
  "privileges": [
    {
      "is_admin": false,
      "object": "databases.dsstest.tables.csv_par_table",
      "privileges": [
        "SELECT"
      ],
      "user_name": "tent2"
    },
    {
      "is_admin": true,
      "object": "databases.dsstest.tables.csv_par_table",
      "privileges": [
        "ALL"
      ],
      "user_name": "tent4"
    }
  ]
}

调用API出错后,将不会返回上述结果,而是返回错误码和错误信息,详细介绍请参见错误码