Update Asset Tree¶

更新资产树的信息。

操作权限¶

确保已获取调用该 API 的权限。更多信息，参见获取 API 调用权限。

请求格式¶

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

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的 OU ID。如何获取 orgId 信息>>

请求参数（body）¶

名称	必需/可选	数据类型	描述
treeUpdateInfo	必需	TreeUpdateVo 结构体	更新资产树时需要提供的更新详情。见 TreeUpdateVo 结构体>>

TreeUpdateVo 结构体 ¶

名称	必需/可选	数据类型	描述
treeId	必需	String	资产树 ID。
name	当 `tags` 为空时必填	StringI18n	支持国际化的资产树名称。国际化名称结构体>>
tags	当 `name` 为空时必填	Tag结构体	用户自定义标签。标签的作用与表示方法>>

错误码¶

代码	错误信息	描述
99400	Invalid arguments	请求参数非法，请检查请求参数。
99500	System error	服务器内部错误，请联系系统管理员。

示例¶

请求示例¶

url: https://{apigw-address}asset-tree-service/v2.1/asset-trees?action=update&orgId=yourOrgId
method: POST
requestBody:
{
    "treeUpdateInfo":{
        "treeId":"yourTreeId",
        "name":{
            "defaultValue":"Tree Name",
      "i18nValue": null
        },
        "tags":{
            "tag1":"Value1"
        }
    }
}

返回示例¶

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

SDK 示例¶

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

Java
Python