查询数据库用户

功能介绍

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

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

接口约束

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

URI

• URI格式

  GET /v3/{project_id}/instances/{instance_id}/db_user

• URI样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_user

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。

请求消息

无。

响应消息

• 正常响应要素说明

  表2 要素说明

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

  表3 users元素结构说明

  名称	参数类型	说明
  name	String	账号名。
  databases	Array of objects	列表中每个元素表示一个与该账号关联的数据库。 详情请参见表4。

  表4 databases元素结构说明

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

• 正常响应样例

  {
      "users": [
          {
              "name": "rds",
              "databases": [
                  {
                      "name": "rds-test",
                      "readonly": false
                  }
              ]
          },
          {
              "name": "rds001",
              "databases": null
          }
      ]
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。