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);
    }
}