Delete Asset Node


从资产树上移除一个资产节点。待移除的资产可以是一个设备资产,也可以是一个逻辑资产。

操作权限

需授权的资源 所需操作权限
资产树 Full Access

请求格式

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

请求参数(URI)

注解

以下非必须字段中,必须提供 assetId (适用于设备资产和逻辑资产)或 productKey + deviceKey (仅适用于设备资产)的组合,用于指定设备。

名称 位置(Path/Query) 必需/可选 数据类型 描述
orgId Query 必需 String 资产所属的组织 ID。如何获取 orgId 信息>>
treeId Query 必需 String 需要获取的资产树 ID。如何获取资产树信息 ID>>
assetId Query 可选 String 待移除的资产 ID。当存在 assetId 时,以 assetId 为准,当 assetId 不存在时,则看 productKeydeviceKey如何获取 asset ID信息>>
productKey Query 可选 String 待移除设备的 Product Key(用于识别设备资产)。
deviceKey Query 可选 String 待移除设备的 Device Key(用于识别设备资产)。
force Query 可选 Boolean
  • true:删除该节点及其所有子节点
  • false (默认):如果该节点是叶子节点,则删除该节点。如果该节点有子节点,则不允许删除。

注:EnOS Edge 不支持该参数。

错误码

代码 错误信息 描述
17764 The root asset node cannot be deleted. 根节点不能被删除。
17766 The noleaf asset node cannot be deleted. 非叶子节点不能被删除。
17762 The tree is locked 一次只允许一个用户修改资产树,暂时不能操作该资产树,请再次请求。
99400 Invalid arguments 请求参数非法,请检查请求参数。
99404 TreeId does not exist Tree ID 不存在。
99500 System error 服务器内部错误,请联系 EnOS。

示例

请求示例

url: https://{apigw-address}/asset-tree-service/v2.1/asset-nodes?action=delete&orgId=yourOrgId&treeId=yourTreeId&force=true
method: POST

返回示例

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

SDK 示例


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