文档首页/ 硬件开发工具链平台云服务/ API参考/ IPDCenter基础服务API/ 用户组织管理API/ 组织管理接口/ 全局角色管理接口/ 全局角色查询已添加用户接口
更新时间：2026-03-06 GMT+08:00
查看PDF
分享

全局角色查询已添加用户接口

功能介绍

查询全局角色已添加的用户

授权信息

账号需要具备 角色管理 权限点，未绑定情况下需要通过自定义角色进行权限点绑定。具体权限要求请参见权限和授权项。

URI

POST /basic/mgmt/public/api/v1/global/role/user

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

JWTToken
表2 请求body参数

参数

是否必选

参数类型

描述

request

是

UserRoleRequest

查询请求
表3 UserRoleRequest

参数

是否必选

参数类型

描述

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

响应数据
表5 UserInfo

参数

参数类型

描述

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

用户团队信息
表6 UserRole

参数

参数类型

描述

roleId

Long

角色ID

roleName

String

角色名称

roleType

String

角色类型

description

String

描述
表7 Group

参数

参数类型

描述

groupId

Long

群组ID

name

String

群组名称

description

String

描述
表8 UserTeam

参数

参数类型

描述

teamId

Long

团队id

teamName

String

团队名字

description

String

团队描述

userTeamRoles

Array of TeamRole

团队角色
表9 TeamRole

参数

参数类型

描述

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",
          "descripation": "测试群组AAA"
        }
      ],
      "isLoginLimited": 0,
      "userTeams": null
    }
  ],
  "totalCount": 1
}

错误码

请参见错误码。

相关文档