Get Users Asset List¶
不登录 EnOS 应用门户的状态下获取一批用户的资源权限。
操作权限¶
需要在 EnOS 应用门户给应用授权“获取本 OU 内所有用户的权限信息”的权限。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/user/users/assetList
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
organizationId |
必需 |
String |
组织 ID。如何获取 organizationId 信息>> |
userIds |
必需 |
List |
用户 ID 列表 |
resourceTypes |
可选 |
Array |
按指定的资源类型过滤资源,支持输入最多 1000 种资源类型。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
Data 结构体 |
用户及其对应资源的信息。 |
Data 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
usersUserAssets |
UsersUserAssetsDTO 结构体 |
用户及其对应资源的信息。 |
userAssets |
UserAssetInfoDTO 结构体 |
资源信息。 |
type |
String |
资源类型。 |
typeName |
I18nString |
资源类型的国际化名称。结构见 国际化名称结构体>>。 |
UsersUserAssetsDTO 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
userId |
String |
用户 ID。 |
userAssetIds |
List |
资源 ID 列表。 |
UserAssetInfoDTO 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
资源 ID。 |
name |
I18nString |
资源名称。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
参数错误,长度错误,不能为空等。 |
31403 |
应用未被授权“获取本 OU 内所有用户的权限信息”的权限。 |
31404 |
未找到组织。 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/user/users/assetList
method: POST
{"organizationId":"yourOrgId",
"userIds": ["user1","user2","user3"],
"resourceTypes": ["type1", "type2"]}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"usersUserAssets": [
{
"userId": "your_user_id",
"userAssetIds": [
"your_asset_id"
]
}
],
"userAssets": [
{
"id": "Vc8RXLiG",
"name": {
"default": "autoTree",
"en_US": "autoTree_EN",
"zh_CN": "自动化树",
},
"type": "auth_unit",
"typeName": {
"default": "Physical Resource",
"en_US": "Physical Resource",
"zh_CN": "实体资产"
}
}
]
}
}