
# 全局角色查询已添加用户接口
#### 功能介绍
查询全局角色已添加的用户
#### 授权信息
账号需要具备**角色管理** 权限点，未绑定情况下需要通过自定义角色进行权限点绑定。具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。
#### URI
POST /basic/mgmt/public/api/v1/global/role/user
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| Authorization | 是    | String | JWTToken |
   
表2请求body参数 
| 参数      | 是否必选 | 参数类型            | 描述   |
|:---|:---|:---|:---|
| request | 是    | UserRoleRequest | 查询请求 |
   
表3UserRoleRequest 
| 参数        | 是否必选 | 参数类型    | 描述     |
|:---|:---|:---|:---|
| roleId    | 是    | String  | 全局角色id |
| pageIndex | 是    | Integer | 页数     |
| pageSize  | 是    | Integer | 每页大小   |
| name      | 否    | String  | 角色名称   |
   
#### 请求示例
```
{
  "pageIndex": 1,
  "pageSize": 10,
  "name": "",
  "roleId": "837635050227896320"
}
```
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                                  | 描述      |
|:---|:---|:---|
| code       | String                                                                | 返回码     |
| message    | String                                                                | 返回码描述   |
| totalCount | Long                                                                  | 返回数据总条数 |
| datas      | Array of [UserInfo] | 响应数据    |
   
 表5UserInfo 
| 参数             | 参数类型                                                                   | 描述                |
|:---|:---|:---|
| tenantId       | String                                                                 | 租户ID              |
| userId         | String                                                                 | 用户ID              |
| username       | String                                                                 | 用户名称              |
| nickname       | String                                                                 | 用户昵称              |
| orgCode        | String                                                                 | 部门编码              |
| email          | String                                                                 | 邮件                |
| userLevel      | Integer                                                                | 用户级别              |
| effectTime     | String                                                                 | 生效时间              |
| expiredTime    | String                                                                 | 失效时间              |
| password       | String                                                                 | 密码，返回始终为null      |
| status         | Integer                                                                | 状态，1有效，0无效        |
| modifyPwdFlag  | Integer                                                                | 是否需要修改密码，1需要，0不需要 |
| employeeNumber | String                                                                 | 工号                |
| isLoginLimited | Integer                                                                | 是否被登录限制           |
| salt           | String                                                                 | 盐值，返回始终为null      |
| reserve1       | String                                                                 | 扩展字段              |
| reserve2       | String                                                                 | 扩展字段              |
| reserve3       | String                                                                 | 扩展字段              |
| reserve4       | String                                                                 | 扩展字段              |
| reserve5       | String                                                                 | 扩展字段              |
| userRoleLists  | Array of [UserRole]  | 用户角色列表            |
| userGroups     | Array of [Group]    | 用户群组列表            |
| userTeams      | Array of [UserTeam] | 用户团队信息            |
   
 表6UserRole 
| 参数          | 参数类型   | 描述   |
|:---|:---|:---|
| roleId      | Long   | 角色ID |
| roleName    | String | 角色名称 |
| roleType    | String | 角色类型 |
| description | String | 描述   |
   
 表7Group 
| 参数          | 参数类型   | 描述   |
|:---|:---|:---|
| groupId     | Long   | 群组ID |
| name        | String | 群组名称 |
| description | String | 描述   |
   
 表8UserTeam 
| 参数            | 参数类型                                                                    | 描述   |
|:---|:---|:---|
| teamId        | Long                                                                    | 团队id |
| teamName      | String                                                                  | 团队名字 |
| description   | String                                                                  | 团队描述 |
| userTeamRoles | Array of [TeamRole] | 团队角色 |
   
 表9TeamRole 
| 参数             | 参数类型   | 描述     |
|:---|:---|:---|
| teamRoleId     | Long   | 群组id   |
| teamRoleName   | String | 群组名字   |
| teamRoleNameEn | String | 群组英文名字 |
| description    | String | 群组中文描述 |
   
#### 响应示例
```
{
  "code": "IPDC.01020000",
  "message": "success",
  "datas": [
    {
      "tenantId": null,
      "userId": "2000003",
      "username": "public@ipdcenter203.huaweiapaas.com",
      "nickname": "public",
      "orgCode": null,
      "email": "\r\nzhangli400@huawei.com",
      "userLevel": 1,
      "effectTime": "2023-01-01 00:00:00",
      "expiredTime": "2099-12-31 23:59:59",
      "reserve1": "1ac2de80-9f44-4176-8474-a3818d4b20e5",
      "reserve2": "IPDCenter",
      "reserve3": null,
      "reserve4": null,
      "reserve5": null,
      "password": null,
      "status": 1,
      "modifyPwdFlag": 0,
      "salt": null,
      "employeeNumber": null,
      "userRoleLists": [
        {
          "roleId": "-3",
          "roleName": "安全审计员",
          "description": "负责系统管理员、安全保密管理员操作行为审计",
          "roleType": "XDMRole"
        }
      ],
      "userGroups": [
        {
          "groupId": 753338227766612000,
          "name": "测试群组AAA",
          "description": "测试群组AAA"
        }
      ],
      "isLoginLimited": 0,
      "userTeams": null
    }
  ],
  "totalCount": 1
}
```
**状态码： 401**
认证失败
```
{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}
```
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。
