Create Asset Tree¶

Create an asset tree as well as its root node.

Operation Permissions¶

Required Authorization	Required Operation Permission
Asset Tree Service	Full Access

Request Format¶

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

Request Parameters (URI)¶

Name	Location (Path/Query)	Required or Not	Data Type	Description
orgId	Query	true	String	Organization ID which the asset belongs to. How to get orgId

Request Parameters (Body)¶

Name	Required or Not	Data Type	Description
asset	true	Asset struct	Details required when creating an root node asset. See Asset Struct

Asset Struct ¶

Name	Required or Not	Data Type	Description
name	true	StringI18n	Asset name that supports internationalization. For the structure, see Internationalized name struct
timezone	true	String	Timezone where the asset is located. <br>Use the “+08:00” format to indicate time zones that do not support daylight saving time. <br>Use the Asia/Shanghai” format to indicate time zones that support daylight saving time. <br>For details, see Timezone representation
description	false	String	Asset description
attributes	false	Map (Key is of String type, and the Value is of object type)	Attributes of the model which the asset belongs to. For details, see attributes representation
tags	false	Tag struct	User-customized tags. For details, see How to use tag

Response Parameters¶

Name	Data Type	Description
data	String	Created asset tree ID.

Sample 1¶

Request Sample¶

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

{"asset":{
    "modelId": "eeeewqqw",
    "name": {
        "defaultValue": "hahah"
    },
    "timezone": "+12:00",
    "attributes":{},
    "description": "test example by tj"
}
}

Return Sample¶

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