Get Assets by Application¶
查询当前用户在某个应用下有权限的所有资产。
操作权限¶
用户需要登录 EnOS 应用门户。
约束条件¶
组织已购买相关应用。
应用需被组织管理员授予访问用户资产的权限。
请求格式¶
GET https://{apigw-address}/app-portal-service/v2.2/user/app/asset/tree
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
accessKey |
Query |
必需 |
String |
应用的服务账号,应用以 |
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
Authorization |
必需 |
String |
Access Token,以Bearer Token表示,其形式为`Bearer {your token}`,需要通过调用 Log In 或 Refresh Access Token 接口后获取 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
data 结构体 |
资产列表 |
tags |
List<StructureTagDTO> |
组织结构标签 |
displayOrder |
Integer |
排序序号 |
nameJson |
String |
域名称,多语言,json结构 |
data 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
节点ID |
name |
String |
节点名称 |
tag |
String |
节点标签,如果当前节点为资产,则标签为”asset”,否则此节点为组织结构节点,对应标签为“null”。(由于资产只能挂载到组织结构的叶子节点上,所以当此标签为”asset”时,必有父节点且父节点为组织结构节点,同时必然没有子节点) |
parentId |
String |
父节点ID |
children |
data结构体列表 |
子节点 |
StructureTagDTO 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
Integer |
组织结构标签序号 |
key |
String |
组织结构标签键名 |
value |
String |
组织结构标签值 |
错误码¶
代码 |
描述 |
---|---|
31400 |
AccessKey 不能为空 |
31401 |
提供的 Access Token 无效 |
31403 |
没有此应用权限 |
31404 |
应用不存在或组织未购买此应用 |
31512 |
未选择 OU |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/user/app/asset/tree?accessKey=app_1
method: GET
headers: {"Authorization":"Bearer APP_PORTAL_S_TDKKeqfYBK3m5z3LRgKVqThWDYnRBN44"}
返回示例¶
{
"id": "sg1566xxxxxxxxxx",
"name": "Solar_shangHai",
"tag": null,
"displayOrder": 0,
"parentId": "",
"nameJson": {
"default": "Solar_shangHai"
},
"tags": [
{
"id": 75,
"key": "aaa",
"value": "bbb"
}
]
"children": [
{
"id": "sg15663524029331",
"name": "JiangYin",
"tag": null,
"displayOrder": 0,
"parentId": "sg1566xxxxxxxxxx",
"nameJson": {
"default": "JiangYin"
},
"tags": null,
"children": [
{
"id": "zULM004t",
"name": "Solar_Assert",
"tag": "asset",
"displayOrder": 0,
"parentId": "",
"nameJson": {
"default": "Solar_Assert"
},
"tags": null,
"children": null
},
{
"id": "osvxGtJC",
"name": "shangHai",
"tag": "asset",
"displayOrder": 1,
"parentId": "",
"nameJson": {
"default": "shangHai"
},
"tags": null,
"children": null
}
]
}
]
}