Create Asset Tree¶

创建一棵资产树，并同时创建该资产树的根节点。

操作权限¶

需授权的资源	所需操作权限
资产树	Full Access

请求格式¶

POST https://{apigw-address}/asset-tree-service/v2.1/asset-trees?action=create

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织ID。如何获取orgId信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
asset	必需	Asset 结构体	创建根节点资产所需的详情。见 Asset结构体>>
tree	可选	TreeCreateVo 结构体	创建资产树所需要的详情。见 TreeCreateVo结构体>>

Asset 结构体 ¶

名称	必需/可选	数据类型	描述
modelId	必需	String	资产所属模型 ID。如何获取 modelId 信息>>
name	必需	StringI18n	支持国际化的资产名称。其结构参见国际化名称结构体>>
timezone	必需	String	资产所属时区。使用 +08:00 格式表示不支持夏令时的时区。使用 Asia/Shanghai 格式表示支持夏令时的时区。详情参见时区表示方法。
description	可选	String	资产描述。
attributes	可选	Map（Key 为 String，Value 为 Object）	资产所属的模型属性。attributes的表示方法>>
tags	可选	Map（Key 为 String，Value 为 String）	用户自定义标签。标签的作用与表示方法>>

TreeCreateVo结构体 ¶

名称	必需/可选	数据类型	描述
name	可选	StringI18n	支持国际化的资产树名称。见国际化名称结构体>>
tags	可选	Map	用户自定义标签。详情请见标签的作用与表示方法>>

响应参数¶

名称	数据类型	描述
data	String	创建的资产树 ID。

错误码¶

代码	错误信息	描述
17772	The quota of tree reaches ceiling	资产树数量达到OU上限。
99400	Invalid arguments	请求参数非法，请检查请求参数。
99500	System error	服务器内部错误，请联系EnOS。

示例¶

请求示例¶

url: https://{apigw-address}/asset-tree-service/v2.1/asset-trees?action=create&orgId=yourOrgId
method: POST
requestBody:
{
    "asset":{
        "modelId":"yourModelId",
        "name":{
            "defaultValue":"Name"
        },
        "timezone":"+12:00",
        "description":"Example of description"
    },
    "tree":{
        "name":{
            "defaultValue":"Name"
        }
    }
}

返回示例¶

{
  "msg":  "OK",
  "code": 0,
  "data": "yourAssetTreeId",
  "requestId": "bb4f8c40-604a-451e-83bd-99cfba6bd53e"
}

SDK 示例¶

你可以在 Github 上获取资产树服务 API 的 SDK 示例：

Java
Python