Get Users Asset List


批量获取用户权限内的资源。

前提条件


应用需拥有“获取本 OU 内所有用户的权限信息”的权限。如有需要,联系 OU 管理员获取权限。

请求格式


POST https://{apigw-address}/app-portal-service/v2.2/user/users/assetList

请求参数(Body)


名称

必需/可选

数据类型

描述

organizationId

必需

String

OU ID。如何获取 organizationId 信息 >>

userIds

必需

List

用户 ID 列表,支持输入最多 1000 个用户 ID。如何获取 userId 信息 >>

resourceTypes

可选

Array

按指定的资源类型过滤资源,支持输入最多 1000 种资源类型。可通过 Get Resource Type API 获取资源类型列表。

响应参数


名称

数据类型

描述

usersUserAssets

UsersUserAssetsDTO 结构体。

用户及其对应资源的信息。UsersUserAssetsDTO 结构体 >>

userAssets

UserAssetInfoDTO 结构体。

资源信息。UserAssetInfoDTO 结构体 >>

UsersUserAssetsDTO 结构体


名称

数据类型

描述

userId

String

用户 ID。

userAssetIds

List

资源 ID 列表。

UserAssetInfoDTO 结构体


名称

数据类型

描述

id

String

资源 ID。

name

I18nString

资源名称。

type

String

资源类型代码。

typeName

I18nString

资源类型的国际化名称。国际化名称结构体 >>

错误码


代码

描述

31400

参数错误,长度错误,不能为空等。

31403

应用未被授予“获取本 OU 内所有用户的权限信息”的权限。

31404

未找到 OU。

示例

请求示例


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": "resourceId",
        "name": {
          "default": "autoTree",
          "en_US": "autoTree_EN",
          "zh_CN": "",
        },
        "type": "auth_unit",
        "typeName": {
          "default": "Physical Resource",
          "en_US": "Physical Resource",
          "zh_CN": ""
        }
      }
    ]
  }
}