更新时间:2024-08-20 GMT+08:00

查询数据库用户列表

功能介绍

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

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

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

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

instance_id

String

参数解释:

实例ID。标识实例的唯一标识。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

offset

Integer

参数解释:

分页符。从第一条数据偏移offset页数据后开始查询例如:该参数指定为1,limit指定为10,则只展示第11-20条数据。

约束限制:

不涉及。

取值范围:

[0, 2^31-1]

默认取值

默认为0(偏移0条数据,表示从第一条数据开始查询)。

limit

Integer

参数解释:

每页显示的条目数量。

约束限制:

不涉及。

取值范围:

[1, 100]

默认取值

默认为10。

请求参数

无。

响应参数

表2 参数说明

参数

参数类型

描述

users

Array of objects

参数解释:

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

total_count

Integer

参数解释:

总记录数。

取值范围:

[0, 2^31-1],取决于实际查询大小。

表3 users字段数据结构说明

参数

参数类型

描述

name

String

参数解释:

用户名称。

取值范围:

不涉及。

attribute

Object

参数解释:

用户的权限属性,详情参见表 attribute字段数据结构说明

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
}

状态码

错误码

请参见错误码