文档首页/ 硬件开发工具链平台云服务/ API参考/ IPDCenter基础服务API/ 用户组织管理API/ 用户接口/ 查询用户权限
更新时间：2024-08-13 GMT+08:00
查看PDF
分享

查询用户权限

功能介绍

查询用户权限。

URI

GET /unidata/public/api/v1/xdm-user/principal/list

表1 Query参数

参数

是否必选

参数类型

描述

user_id

否

String

用户id

offset

否

String

偏移量，表示从此偏移量开始查询，offset大于等于0

缺省值：0

最小长度：0

最大长度：50000

limit

否

String

分页大小，每页显示的条目数量

缺省值：10

最小长度：1

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

JWTToken
表3 请求Body参数

参数

是否必选

参数类型

描述

limit

否

Integer

分页大小，每页显示的条目数量

最小值：1

缺省值：10

offset

否

Integer

偏移量，表示从此偏移量开始查询，offset大于等于0

最小值：0

最大值：50000

缺省值：0

user_id

否

String

用户id

username

否

String

用户名

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

code

String

异常编码

message

String

异常信息

total_count

String

数据总条数

datas

Array of UserPrincipalData objects

权限数据集
表5 UserPrincipalData

参数

参数类型

描述

principal_id

String

参与者id

principal_name

String

参与者名称

operation_codes

Array of strings

操作编码集合

operations

Array of operations objects

操作具体明细

entity_name

String

操作实体名称

entity_id

String

实体id

condition_group

String

条件组

policy_sets

policy_sets object

策略集合

negative

Boolean

黑白名单标识，true为黑名单，false为白名单
表6 operations

参数

参数类型

描述

code

String

操作编码

name

String

操作名称

name_en

String

操作英文名称

id

String

操作id
表7 policy_sets

参数

参数类型

描述

id

String

策略id

name

String

策略名称

name_en

String

策略英文名称

code

String

策略编码

description

String

策略描述

id_full_path

String

策略路径id

状态码： 400

表8 响应Body参数

参数

参数类型

描述

reserve

String

保留字段

error_code

String

错误编码

error_msg

String

错误信息

请求示例

{{host}}/unidata/public/api/v1/xdm-user/principal/list?offset=0&limit10

响应示例

状态码： 200

成功

{
  "code" : "IPDC.01040000",
  "message" : "success",
  "datas" : [ {
    "principal_id" : "625049160860569600",
    "principal_name" : "xxx@ipdctest.huaweiapaas.com 1008600000075588330",
    "operation_codes" : [ "000000001", "000000002" ],
    "operations" : [ {
      "code" : "000000001",
      "name" : "创建",
      "name_en" : "create",
      "id" : "568813498281234432"
    }, {
      "code" : "000000002",
      "name" : "删除",
      "name_en" : "delete",
      "id" : "568813498281234433"
    } ],
    "entity_name" : "ChangeActivity",
    "entity_id" : "614488993089728512",
    "condition_group" : null,
    "policy_set" : {
      "id" : "615246721659711488",
      "name" : "项目",
      "name_en" : "Project",
      "code" : "000000003",
      "description" : null,
      "id_full_path" : "615246721659711488/"
    },
    "negative" : false
  } ],
  "total_count" : 1
}

状态码： 400

认证失败

{
  "reserve" : null,
  "error_code" : "AUTH-600001",
  "error_msg" : ""
}

状态码

状态码

描述

200

成功

400

认证失败

500

服务器内部异常

错误码

请参见错误码。

父主题： 用户接口

相关文档