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。当存在 |
productKey |
Query |
可选 |
String |
待移除设备的 Product Key(用于识别设备资产)。 |
deviceKey |
Query |
可选 |
String |
待移除设备的 Device Key(用于识别设备资产)。 |
force |
Query |
可选 |
Boolean |
注: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 示例: