Update Asset Tree¶
更新资产树的信息。
操作权限¶
需授权的资源 |
所需操作权限 |
---|---|
资产树管理 |
Full Access |
请求格式¶
POST https://{apigw-address}/asset-tree-service/v2.1/asset-trees?action=update
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织ID。如何获取orgId信息>> |
请求参数(body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
treeUpdateInfo |
必需 |
TreeUpdateVo结构体 |
更新资产树时需要提供的更新详情。见 TreeUpdateVo结构体>> |
TreeUpdateVo结构体 ¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
treeId |
必需 |
String |
资产树ID。 |
name |
可选 |
StringI18n |
支持国际化的资产树名称。结构请见 国际化名称结构体>> |
tags |
可选 |
Tag结构体 |
用户自定义标签。详情见 标签的作用与表示方法>> |
错误码¶
名称 |
错误信息 |
描述 |
---|---|---|
99400 |
Invalid arguments |
请求参数非法,请检查请求参数。 |
99500 |
System error |
服务器内部错误,请联系EnOS。 |
示例¶
请求示例¶
url: https://{apigw-address}asset-tree-service/v2.1/asset-trees?action=update&orgId=yourOrgId
method: POST
requestBody:
{
"treeUpdateInfo":{
"treeId":"yourTreeId",
"name":{
"defaultValue":"aaaa",
"i18nValue": null
},
"tags":{
"ss":"f"
}
}
}
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "01b5477a-374e-49a0-8b68-7dbfe8f0b74f",
"data": null
}
Java SDK调用示例¶
package com.envisioniot.enos.asset_tree_service;
import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.api.common.constant.request.Pagination;
import com.envisioniot.enos.api.common.constant.request.Projection;
import com.envisioniot.enos.asset_tree_service.v2_1.*;
import com.envisioniot.enos.asset_tree_service.vo.AssetCreateVo;
import com.envisioniot.enos.asset_tree_service.vo.I18nVo;
import com.envisioniot.enos.asset_tree_service.vo.TreeCreateVo;
import com.envisioniot.enos.asset_tree_service.vo.TreeUpdateVo;
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
public class AssetTreeTest {
private static String AccessKey = "yourAccessKey";
private static String SecretKey = "yourSecretKey";
private static String OrgId = "yourOrgId";
private static String ServerUrl = "yourServerUrl";
@Test
public void testUpdateTree() {
UpdateTreeRequest request = new UpdateTreeRequest();
request.setOrgId(OrgId);
TreeUpdateVo treeUpdateVo = new TreeUpdateVo();
treeUpdateVo.setTreeId("yourTreeId");
I18nVo name = new I18nVo();
name.setDefaultValue("treeDefaultName");
treeUpdateVo.setName(name);
Map < String, String > tagMap = new HashMap < > ();
tagMap.put("key1", "value1");
treeUpdateVo.setTags(tagMap);
request.setTreeUpdateInfo(treeUpdateVo);
UpdateTreeResponse response = Poseidon.config(PConfig.init().appKey(AccessKey).appSecret(SecretKey).debug())
.url(ServerUrl)
.getResponse(request, UpdateTreeResponse.class);
}
}