查询数据库用户列表

功能介绍

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

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

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

URI

• URI格式

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

• 参数说明

  表1 参数说明

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

请求消息

无。

响应消息

• 正常响应要素说明

  表2 要素说明

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

  表3 users元素结构说明

  名称	参数类型	说明
  name	String	帐号名。
  state	String	数据库用户状态。 “unavailable”表示不可用。 “available”表示可用。

• 正常响应样例

  {
   "users": [
      {
       "name": "rdsuser",
       "state": "available"
      },
     {
      "name": "login001",
      "state": "available"
      }
   ],
   "total_count": 3
   }

状态码

请参见状态码。

错误码

请参见错误码。