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