更新时间:2024-03-28 GMT+08:00

查询数据库用户列表

功能介绍

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

接口约束

  • 实例在异常或冻结状态下不能执行该操作。
  • 不支持查询只读实例的数据库用户列表。

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/db_user/detail?page={page}&limit={limit}

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

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

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

    instance_id

    实例ID。

    page

    分页页码,从1开始。

    limit

    每页数据条数。取值范围[1, 100]。

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_user/detail?page=1&limit=10

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    users

    Array of objects

    数据库账号信息列表。

    详情请参见表3

    total_count

    Integer

    数据库账号个数。

    表3 users元素结构说明

    名称

    参数类型

    说明

    name

    String

    账号名。

    comment

    String

    账号备注。目前仅支持MySQL 8.0.25及以上版本。

    databases

    Array of objects

    账号已授权的数据库。

    详情请参见表4

    hosts

    Array of strings

    账号配置的host信息。

    表4 databases元素结构说明

    参数

    参数类型

    描述

    name

    String

    数据库名称。

    readonly

    Boolean

    授权模式,是否只读。

  • 正常响应样例
    {
        "users": [
            {
                "name": "aaa",
                "comment": "user comment",
                "databases": [
                    {
                        "name": "db1",
                        "readonly": false
                    }
                ],
                "hosts": [
                    "10.%"
                ]
            }
        ],
        "total_count": 1
    }

状态码

错误码

请参见错误码