Get Assets by Application


查询当前用户在某个应用下有权限的所有资产。

操作权限


用户需要登录 EnOS 应用门户。

约束条件


  • 组织已购买相关应用。

  • 应用需被组织管理员授予访问用户资产的权限。

请求格式


GET https://{apigw-address}/app-portal-service/v2.2/user/app/asset/tree

请求参数(URI)


名称

位置(Path/Query)

必需/可选

数据类型

描述

accessKey

Query

必需

String

应用的服务账号,应用以 accessKey 进行鉴权以获得其被授权访问的数据。如何获取accessKey信息>>

响应参数


名称

数据类型

描述

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
        }
      ]
    }
  ]
}