map.update

描述

object map.update(object/array maps)

此方法允许更新现有地图。

该方法可供任何类型的用户使用。调用该方法的权限可以在用户角色设置中撤销。更多信息请参阅User roles

参数

(object/array) 待更新的地图属性

每个地图必须定义mapid属性,其他属性均为可选。仅传递的属性会被更新,其余属性将保持不变。

地图外,该方法还接受以下参数:

参数 数据类型 说明
links array 用于替换现有链接的地图地图链接
selements array 用于替换现有元素的地图地图元素
urls array 用于替换现有URL的地图地图-url
users array 用于替换现有元素的地图地图用户共享
userGroups array 用于替换现有元素的地图映射用户组共享
shapes array 用于替换现有图形的地图地图形状
lines array 用于替换现有线条的地图地图连线

要在新地图元素之间创建地图链接,您需要将元素的selementid设置为任意值,然后在链接的selementid1selementid2属性中使用该值引用此元素。当元素创建时,该值将被Zabbix生成的正确ID替换。创建主机地图

返回值

(object) 返回一个包含更新地图ID的object,存储在sysmapids属性下。

示例

调整地图尺寸

将地图尺寸修改为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
       }

另请参阅

来源

位于 ui/include/classes/api/services/CMap.php 中的 CMap::update() 方法。