查询数据库用户列表 - ListDbUsers

功能介绍

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

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要了解请求Header参数说明。

调试

您可以在API Explorer中调试该接口。

授权信息

接口约束

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

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
  }

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。