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