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信息>>

请求参数（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
        }
      ]
    }
  ]
}