查询数据库用户列表

功能介绍

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

• 调用接口前，您需要了解API 认证鉴权。

调试

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

接口约束

• 实例在创建、变更规格、修改端口、异常或冻结状态下不能执行该操作。

• 除RDS界面和API以外的其他方式创建的数据库和账号，如果创建的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），例如包含中文或不支持的特殊字符，那么该数据库和账号不支持RDS界面或API的数据库管理和账号管理功能。
• 如果源库的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），迁移到目标库RDS for MySQL后，该数据库和账号也不支持RDS界面或API的数据库管理和账号管理功能。

URI

• URI格式

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

请求消息

• 请求参数

  无。

• URI样例

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

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  users	Array of objects	列表中每个元素表示一个数据库用户。 详情请参见表3。
  total_count	Integer	数据库用户总数。

  表3 users元素结构说明

  名称	参数类型	说明
  name	String	账号名。
  attributes	Object	用户的权限属性。 详情请参见表4。
  memberof	Array of strings	用户的默认权限。
  comment	String	用户备注。

  表4 attributes 元素结构说明

  名称	参数类型	说明
  rolsuper	Boolean	用户是否具有超级用户权限，取值为“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”。

• 正常响应样例

  {
  "users": [
  {
    "name": "rdsuser",
    "attributes": {
      "rolsuper": false,
      "rolinherit": true,
      "rolcreaterole": true,
      "rolcreatedb": true,
      "rolcanlogin": true,
      "rolconnlimit": -1,
      "rolreplication": true,
      "rolbypassrls": false
     },
    "memberof": ["pg_monitor", "pg_read_all_stats", "pg_stat_scan_tables", "pg_signal_backend"]
  }, 
  {
    "name": "rdsuser1",
    "attributes": {
      "rolsuper": false,
      "rolinherit": true,
      "rolcreaterole": true,
      "rolcreatedb": true,
      "rolcanlogin": true,
      "rolconnlimit": -1,
      "rolreplication": true,
      "rolbypassrls": false
  },
    "memberof": []
  }],
  "total_count": 2
  }

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。