查询指定用户的已授权数据库

功能介绍

查询指定实例中某数据库用户的已授权数据库。

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

接口约束

• 实例在异常或冻结状态下不能执行该操作。
• 如果用户自行使用SQL命令删除数据库，在通过API或RDS界面查询已授权数据库列表时会显示已删除的数据库。
• 通过SQL语句使用*.*方式授权的数据库（GRANT ALL ON *.* TO `user`@`host`），调用该接口查询结果返回为空。如需查看结果，可使用show grants for命令代替接口查询。

  建议使用指定数据库方式授权：GRANT ALL ON db1.* TO `user`@`host`

URI

• URI格式

  GET /v3/{project_id}/instances/{instance_id}/db_user/database?user-name={user-name}&page={page}&limit={limit}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。
  user-name	是	数据库用户名。
  page	是	分页页码，从1开始。
  limit	是	每页数据条数。取值范围[1, 100]。

请求消息

• 请求参数

  无。

• URI样例

  GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_user/database?user-name=rds&page=1&limit=10

响应消息

• 正常响应要素说明

  表2 要素说明

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

  表3 databases元素结构说明

  名称	参数类型	说明
  name	String	数据库名称。
  readonly	Boolean	是否为只读权限： true表示只读。 false表示可读写。

• 正常响应样例

  {
      "databases": [
          {
              "name": "rds-test",
              "readonly": false
          },
          {
              "name": "testdb1",
              "readonly": true
          },
          {
              "name": "tt",
              "readonly": false
          }
      ],
      "total_count": 3
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。