Get Assets by Organization¶
获取指定用户在指定组织下有权限的所有资产。
操作权限¶
用户无需登录 Application Portal。
约束条件¶
关联的应用已被组织购买
应用需被组织管理员授予访问用户资产的权限
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/user/asset/list
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
userId |
必需 |
String |
用户的ID。 |
orgId |
必需 |
String |
资产所属的组织ID。如何获取orgId信息>> |
pagination |
可选 |
Pagination请求结构体 |
分页参数。见 Pagination请求结构体>> (若不提供,则默认按照每页1000条数据的格式返回第0页的数据)。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
data结构体 |
以分页列表展示资产信息。 |
data结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
pagination |
Pagination结构体 |
分页信息。 |
assets |
assets结构体 |
资产信息列表。 |
Pagination结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
pageNo |
Integer |
请求页数。 |
pageSize |
Integer |
每页记录数。 |
totalElements |
Long |
总记录数。 |
assets结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
资产ID。 |
name |
I18nString |
该资产的各语言名称。结构见 国际化名称结构体>> |
orgId |
String |
资产所属的组织ID。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
用户ID或组织ID不能为空 |
31403 |
应用未被授权访问用户信息或资产信息 |
31404 |
未找到对应用户或此用户在不存在于该组织 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/user/asset/list
method: POST
requestBody:
{
"userId": "yourUserId",
"orgId": "yourOrgId",
"pagination": {
"pageNo": 0,
"pageSize": 1000,
"sorters": []
}
}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"pagination": {
"totalElements": 2,
"pageNo": 0,
"pageSize": 1000
},
"assets": [
{
"id": "2rVQ6zfF",
"name": {
"default": "wyf_asset_01",
"en_US": "wyf_asset_01"
}
},
{
"id": "Sx0faZHR",
"name": {
"default": "12345678901234567890123456789012345678901234567890",
"en_US": "12345678901234567890123456789012345678901234567890"
}
}
]
}
}
Java SDK 调用示例¶
public class AppPortalSdkTest{
@Test
public void getAssetsByOrganizationTest() {
UserAssetListRequest userAssetListRequest=new UserAssetListRequest("your_user_id","your_org_id");
UserAssetListResponse response=Poseidon.config(PConfig.init().appKey("your_access_key").appSecret("your_secret_key").debug())
.url("https://{apigw-address}").getResponse(userAssetListRequest,UserAssetListResponse.class);
assertNotNull("Response should not be null", response);
assertNotNull("Response data should not be null", response.data);
assertNotNull("Asset could not be null", response.data.assets);
assertNotNull("Asset name could not be null", response.data.assets.get(0).name);
}
}