# 查询数据库用户列表-QueryingDetailsAboutDatabaseUsers
#### 接口说明
查询数据库用户列表。
#### 约束说明
- 该接口支持DDS社区版。
- 实例在创建、规格变更、修改端口、重启等过程中以及状态为非"normal"时，不允许执行该操作。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDS&api=ListDatabaseUsers)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dds/dds_api_permission.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                          | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                              | 别名               | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | dds:instance:getDatabaseUser | read | instance    | [g:EnterpriseProjectId](https://support.huaweicloud.com/api-dds/dds_api_0042.html#dds_api_0042__li1539015369314) | dds:instance:get | -      |
     
  
 
#### URI
- URI格式 GET /v3/{project_id}/instances/{instance_id}/db-user/detail
  
- URI样例
  - 查询数据库用户列表： https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/3527b6b16e7639b88930a360d2c4in02/db-user/detail
    
  
  - 根据指定条件查询用户列表 https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/3527b6b16e7639b88930a360d2c4in02/db-user/detail?offset=0\&limit=100\&user_name=test\&db_name=testDb
    
   
 
表1参数说明 
| 名称           | 参数类型    | 是否必选 | 描述                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | String  | 是    | 从IAM服务获取的用户Token。请参考[认证鉴权](https://support.huaweicloud.com/api-dds/dds_api_0010.html)。                     |
| project_id   | String  | 是    | 租户在某一Region下的项目ID。请参考[获取项目ID](https://support.huaweicloud.com/api-dds/dds_projectid.html)章节获取项目编号。         |
| instance_id  | String  | 是    | 实例ID，可以调用"查询实例列表"接口获取。如果未申请实例，可以调用"创建实例"接口创建。                                                              |
| user_name    | String  | 否    | 用户名称。 取值范围：长度为1\~64位，可以包含大写字母（A\~Z）、小写字母（a\~z）、数字（0\~9）、中划线、下划线和点。          |
| db_name      | String  | 否    | 用户所在的数据库名称，默认为"admin"。 取值范围：长度为1\~64位，可以包含大写字母（A\~Z）、小写字母（a\~z）、数字（0\~9）、下划线。 |
| offset       | Integer | 否    | 索引位置偏移量。 取值大于或等于0。不传该参数时，查询偏移量默认为0。                                           |
| limit        | Integer | 否    | 查询个数上限值。 取值范围：1\~100。不传该参数时，默认查询前100条实例信息。                                   |
   
#### 请求消息
无。
#### 响应消息
- 参数说明
  表2参数说明 
  | 名称          | 参数类型    | 是否必选 | 描述                                                                                                 |
  |:---|:---|:---|:---|
  | users       | String  | 是    | 数据库用户信息。 注意： 返回格式按照数据库原生格式返回，需要用户解析。 |
  | total_count | Integer | 是    | 数据库用户总数。                                                                                           |
     
  

- 响应示例
  ```
  {
    "total_count": 1,
    "users": "[{\"inheritedPrivileges\":[{\"resource\":{\"collection\":\"temproles\",\"db\":\"admin\"},\"actions\":[\"find\"]}],\"roles\":[{\"role\":\"root\",\"db\":\"admin\"}],\"inheritedRoles\":[{\"role\":\"root\",\"db\":\"admin\"}],\"_id\":\"admin.rwuser\",\"user\":\"rwuser\",\"db\":\"admin\"}]"
  }
  ```
  
 
#### SDK
单击[文档数据库服务 DDS SDK](https://sdkcenter.developer.huaweicloud.com/?product=DDS)，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
#### 状态码
详情请参见[状态码](https://support.huaweicloud.com/api-dds/dds_status_code.html)。
#### 错误码
详情请参见[错误码](https://support.huaweicloud.com/api-dds/dds_error_code.html)。