更新时间:2024-06-14 GMT+08:00

查询数据库用户列表

功能介绍

指定实例中查询数据库用户列表。

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-users

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

instance_id

String

实例ID。

offset

Integer

分页符。从第一条数据偏移offset页数据后开始查询,默认为0(偏移0页数据,表示从第一条数据开始查询),必须为数字,不能为负数。例如:该参数指定为1,limit指定为10,则只展示第11-20条数据。

limit

Integer

每页显示的条目数量,取值范围[1, 100],默认10。

请求参数

无。

响应参数

表2 参数说明

参数

参数类型

描述

users

Array of objects

列表中每个元素表示一个数据库用户,详情参见表3

total_count

Integer

数据库用户总数。

表3 users字段数据结构说明

参数

参数类型

描述

name

String

用户名称。

attribute

Object

用户的权限属性,详情参见表4

memberof

String

用户的默认权限。

lock_status

Boolean

用户是否被锁,取值为“true”或“false”。

表4 attribute字段数据结构说明

参数

参数类型

描述

rolsuper

Boolean

用户是否具有管理员权限,取值为“true”或“false”。

rolinherit

Boolean

用户是否自动继承其所属角色的权限,取值为“true”或“false”。

rolcreaterole

Boolean

用户是否支持创建其他子用户,取值为“true”或“false”。

rolcreatedb

Boolean

用户是否可以创建数据库,取值为“true”或“false”。

rolcanlogin

Boolean

用户是否可以登录数据库,取值为“true”或“false”。

rolconnlimit

Integer

用户连接实例的最大并发连接数。-1表示没有限制。

rolreplication

Boolean

用户是否属于复制角色,取值为“true”或“false”。

rolbypassrls

Boolean

用户是否绕过每个行级安全策略,取值为“true”或“false”。

rolpassworddeadline

String

用户密码过期时间。

请求示例

查询数据库用户列表。

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/{instance_id}/db-users

响应示例

查询数据库用户列表成功。

{
    "users": [
        {
            "name": "root",
            "attribute": {
                "rolsuper": false,
                "rolinherit": true,
                "rolcreaterole": true,
                "rolcreatedb": true,
                "rolcanlogin": true,
                "rolconnlimit": -1,
                "rolreplication": false,
                "rolbypassrls": false,
                "rolpassworddeadline": ""

            },
            "memberof": "{gs_role_copy_files,gs_role_signal_backend,gs_role_tablespace,gs_role_replication,gs_role_account_lock}",
            "lock_status": false
        }
    ],
    "total_count": 1
}

状态码

错误码

请参见错误码