Create and Associate Asset

Create a logical asset and associate it with the asset tree.

Operation Permissions

Required Authorization

Required Operation Permission

Asset Tree Service

Full Access

Request Format

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

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

treeId

Query

true

String

ID of the asset tree How to get the ID of an asset tree>>

parentAssetId

Query

true

String

Asset ID of the parent node of the asset to be associated

Request Parameters (Body)

Name

Required or Not

Data Type

Description

asset

true

Asset struct

Asset details to be provided when creating an asset. See Asset Struct

Asset Struct

Name

Required or Not

Data Type

Description

modelId

true

String

Model ID which the asset belongs to. How to get modelID>>

name

true

StringI18n

Asset name that supports internationalization. For the structure, see Internationalized name struct>>

timezone

true

String

Timezone where the asset is located.
Use the “+08:00” format to indicate time zones that do not support daylight saving time.
Use the Asia/Shanghai” format to indicate time zones that support daylight saving time
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 ID

Error Codes

Code

Description

17751

Tree ID does not exist

17752

The parent asset does not exist in this tree

17758

The asset already exists on the tree

17760

The name of the asset to be created is illegal

17770

The tree exceeds the maximum number of layers (7 layers)

Sample 1

Request Sample

POST https://{apigw-address}/asset-tree-service/v2.1/asset-nodes?treeId=lMAXwaLX&action=createAsset&parentAssetId=fy4hxezF&orgId=1c499110e8800000
{
    "asset": {
        "modelId": "STRING-INVERTER-MODEL",
        "name": {
            "defaultValue": "逆变器 #1",
            "i18nValue": {
                "en_US": "Inverter #1"
            }
        },
        "timezone": "+08:00",
        "description": "This is a sampled asset.",
        "attributes": {
            "foo": 100,
            "bar": "example"
        },
        "tags": {
            "foo": "bar",
            "hello": "world"
        }
    }
}

Return Sample

{
    "code": 0,
    "msg": "ok",
    "requestId": "01b5477a-374e-49a0-8b68-7dbfe8f0b74f",
    "data": "cRUdS7sJ"
}