更新拓扑图

描述

object map.update(object/array maps)

此方法可以用来更新已存在的拓扑图

此方法适用于任何类型的用户. 调用该方法的权限可以在用户角色设置中撤销. 请参阅用户角色了解更多信息.

参数

(object/array) 要更新的拓扑图属性。

必须为每个地图定义“mapid”属性,所有其他属性是可选的。只有传递的属性会被更新,所有其他的将保持不变。

除了 标准地图属性,该方法 接受以下参数。

参数 类型 说明
links array Map links 来替换现有的链接。
selements array Map elements 替换现有元素。
urls array 拓扑图 URLs 以替换现有的 URL。
users array Map user 共享以替换现有元素。
userGroups array 拓扑图 用户组 共享以替换现有元素。
shapes array Map shapes 来替换现有的形状。
lines array Map lines 来替换现有的行。

:::noteclassic 要创建地图链接,您需要将地图元素 selementid 设置为任意值,然后使用此值在链接 selementid1 或 selementid2 属性中引用此元素。 创建元素时,该值将替换为 Zabbix 生成的正确 ID, 参考 :::

返回值

返回一个对象,该对象包含"sysmapid"属性下更新的映射的id.

案例

调整拓扑大小

将拓扑大小更改为 1200x1200 像素.

请求:

{
           "jsonrpc": "2.0",
           "method": "map.update",
           "params": {
               "sysmapid": "8",
               "width": 1200,
               "height": 1200
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "8"
               ]
           },
           "id": 1
       }

改变拓扑图的拥有者

仅适用于管理员和超级管理员

请求:

{
           "jsonrpc": "2.0",
           "method": "map.update",
           "params": {
               "sysmapid": "9",
               "userid": "1"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 2
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "9"
               ]
           },
           "id": 2
       }

查看相关

来源

CMap::update() in ui/include/classes/api/services/CMap.php.