# 查询全局角色接口
#### 功能介绍
分页查询全局角色。
#### 授权信息
账号需要具备**角色管理** 权限点，未绑定情况下需要通过自定义角色进行权限点绑定。具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。
#### URI
POST /basic/mgmt/public/api/v1/global/roles
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| Authorization | 是    | String | JWTToken |
   
表2请求Body参数 
| 参数      | 是否必选 | 参数类型                                                                                              | 描述       |
|:---|:---|:---|:---|
| request | 是    | [GlobalRoleResquest] | 查询全局角色请求 |
   
 表3GlobalRoleResquest 
| 参数        | 是否必选 | 参数类型    | 描述   |
|:---|:---|:---|:---|
| roleName  | 否    | String  | 角色名称 |
| pageSize  | 是    | Integer | 每页大小 |
| pageIndex | 是    | Integer | 页数   |
   
#### 请求示例
```
{
  "pageIndex": 1,
  "pageSize": 10,
  "roleName": ""
}
```
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                                                 | 描述      |
|:---|:---|:---|
| code       | String                                                                               | 返回码     |
| message    | String                                                                               | 返回码描述   |
| totalCount | Long                                                                                 | 返回数据总条数 |
| datas      | Array of [GlobalRoleInfoResponse] | 响应数据    |
   
 表5GlobalRoleInfoResponse 
| 参数              | 参数类型                                                                   | 描述              |
|:---|:---|:---|
| roleId          | Long                                                                   | 全局角色ID          |
| roleMemberId    | Long                                                                   | 全局角色和用户/部门的关系ID |
| roleType        | String                                                                 | 全局角色类型          |
| roleNumbers     | Integer                                                                | 全局角色人数          |
| roleName        | String                                                                 | 全局角色名称          |
| roleNameEn      | String                                                                 | 全局角色英文名称        |
| roleDescription | String                                                                 | 全局角色描述          |
| roleLimit       | Integer                                                                | 全局角色限制          |
| privilegeLists  | Array of [Privilege] | 权限集合            |
| userLists       | Array of String                                                        | 用户集合            |
| groupLists      | Array of String                                                        | 群组集合            |
| teamId          | String                                                                 | 团队ID            |
| teamName        | String                                                                 | 团队名称            |
   
 表6Privilege 
| 参数             | 参数类型    | 描述    |
|:---|:---|:---|
| privilegeId    | String  | 权限ID  |
| privilegeName  | String  | 权限名称  |
| privilegeType  | Integer | 权限类型  |
| objectId       | String  | 对象ID  |
| parentId       | String  | 父权限id |
| privilegeLevel | String  | 权限等级  |
   
#### 响应示例
```
{
  "code": "IPDC.01020000",
  "message": "success",
  "datas": [
    {
      "roleId": "841753032348672000",
      "roleMemberId": null,
      "roleType": "XDMRole",
      "roleNumbers": 1,
      "roleName": "机机接口测试",
      "roleNameEn": "machineroletest",
      "roleDescription": "XXX",
      "roleLimit": 5,
      "privilegeLists": [
        {
          "privilegeId": "0003",
          "privilegeName": "应用",
          "privilegeType": 1,
          "objectId": "0003",
          "parentId": "-1",
          "privilegeLevel": "2"
        }
      ],
      "userLists": null,
      "groupLists": null,
      "teamId": null,
      "teamName": null
    }
  ],
  "totalCount": 3
}
```
**状态码： 401**
认证失败
```
{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}
```
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。