Associate Asset


将指定已有资产节点关联到资产树上。待关联的资产可以是一个设备资产，也可以是一个逻辑资产。如果待关联的资产节点是一个设备资产，可使用设备资产的 product key、 device key 或者 asset ID 来描述，如果待关联的资产节点是一个逻辑资产，可使用逻辑资产的 ID 来描述。

操作权限

需授权的资源

所需操作权限

资产树

Full Access

请求格式

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

请求参数（URI）

备注

以下非必须字段中，必须提供 assetId 或 productKey + deviceKey 的组合，用于指定设备。

名称

位置（Path/Query）

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织 ID。如何获取 orgId 信息>>

treeId

Query

必需

String

需要获取的资产树 ID。如何获取资产树信息 ID>>

parentAssetId

Query

必需

String

待关联资产的父资产 ID。

assetId

Query

可选

String

资产 ID。如何获取 assetId 信息>>

productKey

Query

可选

String

设备的 product key，需与 deviceKey 一起使用。

deviceKey

Query

可选

String

设备的 device key，需与 productKey 一起使用。

响应参数

名称

数据类型

描述

data

String

关联成功的资产 ID。

错误码

代码

错误信息

描述

17404

TreeId is not exist

Tree ID 不存在。

17752

Parent assetId is not existed in the tree

父资产不存在该树上。

17758

AssetId is existed in the tree

Asset ID 已存在。

17762

The tree is locked

一次只允许一个用户修改资产树，暂时不能操作该资产树，请再次请求。

17770

Exceeding the layer limit(7)

该树超过最高层数限制（7层）。

99400

Invalid arguments

请求参数非法，请检查请求参数。

99500

System error

服务器内部错误，请联系 EnOS。

示例

请求示例

url: https://{apigw-address}/asset-tree-service/v2.1/asset-nodes?action=associateAsset&orgId=yourOrgId&treeId=yourTreeId&parentAssetId=yourParentAssetId&productKey=yourProductKey&deviceKey=yourDeviceKey
method: POST

返回示例

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

SDK 示例


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