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

查看数据库的使用者

功能介绍

该API用于查看当前数据库有权限使用或访问的所有用户名称。

URI

  • URI格式:

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

  • 参数说明
    表1 URI 参数

    参数名称

    是否必选

    说明

    project_id

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

    database_name

    被查询的数据库名称。

请求消息

无请求参数。

响应消息

表2 响应参数

参数名称

是否必选

参数类型

说明

is_success

Boolean

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

message

String

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

database_name

String

被查询的数据库名称。

privileges

Array of objects

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

表3 privileges参数

参数名称

是否必选

参数类型

说明

is_admin

Boolean

判断用户是否为管理员。

user_name

String

用户名称,即该用户在当前数据库上有权限。

privileges

Array of Strings

该用户在数据库上的权限。

请求示例

响应示例

{
  "is_success": true,
  "message": "",
  "database_name": "dsstest",
  "privileges": [
    {
      "is_admin": true,
      "privileges": [
        "ALL"
      ],
      "user_name": "test"
    },
    {
      "is_admin": false,
      "privileges": [
        "ALTER_TABLE_ADD_PARTITION"
      ],
      "user_name": "scuser1"
    },
    {
      "is_admin": false,
      "privileges": [
        "CREATE_TABLE"
      ],
      "user_name": "scuser2"
    }
  ]
}

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