Get Users Asset List¶
Get the asset permissions of users without logging in to Application Portal.
Operation Permissions¶
In Application Portal, the application must be granted the “Obtain all user permissions in the OU” permission.
Request Format¶
POST https://{apigw-address}/app-portal-service/v2.2/user/users/assetList
Request Parameters (Body)¶
Name |
Mandatory/Optional |
Data Type |
Description |
---|---|---|---|
organizationId |
Mandatory |
String |
The organization ID. How to get organizationId>> |
userIds |
Mandatory |
List |
The list of user IDs. |
Response Parameters¶
Name |
Data Type |
Description |
---|---|---|
data |
Data Struct |
The information about users and their corresponding assets. |
Data Struct¶
Name |
Data Type |
Description |
---|---|---|
usersAssets |
UsersAssetListResponse Struct |
The information about users and their corresponding assets. |
UsersAssetListResponse Struct¶
Name |
Data Type |
Description |
---|---|---|
usersUserAssets |
UsersUserAssetsDTO Struct |
The information about users and their corresponding assets. |
userAssets |
UserAssetInfoDTO Struct |
The asset information. |
UsersUserAssetsDTO Struct¶
Name |
Data Type |
Description |
---|---|---|
userId |
String |
The user ID. |
userAssetIds |
List |
The list of Asset IDs. |
UserAssetInfoDTO Struct¶
Name |
Data Type |
Description |
---|---|---|
id |
String |
The asset ID. |
name |
I18nString |
The asset name. |
Error Codes¶
Code |
Description |
---|---|
31400 |
Errors such as incorrect parameters, empty parameters, character limits exceeded, and so on. |
31403 |
The application has not been granted the “Obtain all user permissions in the OU” permission. |
31404 |
Organization not found. |
Samples¶
Request Sample¶
url: https://{apigw-address}/app-portal-service/v2.2/user/users/assetList
method: POST
requestBody:
{"organizationId":"yourOrgId","userIds": ["user1","user2","user3"]}
Return Sample¶
{
"code": 0,
"message": "OK",
"data": {
"usersUserAssets": [
{
"userId": "u15689477086181",
"userAssetIds": [
"zhjAwHTx",
"0xQjZr53",
"164yFtSp"
]
}
],
"userAssets": [
{
"id": "0xQjZr53",
"name": {
"default": "message201"
}
},
{
"id": "164yFtSp",
"name": {
"default": "message465"
}
},
{
"id": "zhjAwHTx",
"name": {
"default": "appAssert"
}
}
]
}
}
Java SDK Sample¶
public class AppPortalSdkTest{
@Test
public void getUsersAssetList() {
ArrayList<String> userIds = new ArrayList<>();
userIds.add("user1");
userIds.add("user2");
userIds.add("user3");
UsersAssetListRequest usersAssetListRequest = new UsersAssetListRequest(userIds,"your_org_id");
UsersAssetListResponse response = Poseidon.config(PConfig.init().appKey("your_access_key").appSecret("your_secret_key").debug())
.url("https://{apigw-address}").getResponse(usersAssetListRequest, UsersAssetListResponse.class);
System.out.println("List organization res: " + JSON.toJSONString(response));
assertNotNull("Response should not be null", response);
assertNotNull("Response data should not be null", response.data);
}
}