map.update

描述

object map.update(object/array maps)

此方法允许update现有的地图。

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

参数

(object/array) 要更新的 map 属性。

每个 map 都必须定义 mapid 属性，其他所有属性都是可选的。只有传入的属性会被更新，其余属性将保持不变。

除了标准 map 属性之外，该方法还接受以下参数。

Parameter Type Description
links array 用于替换现有链接的Map links。
selements array 用于替换现有元素的Map elements。
urls array 用于替换现有 URL 的Map URLs。
users array 用于替换现有元素的Map user 共享。
userGroups array 用于替换现有元素的Map user group 共享。
shapes array 用于替换现有形状的Map shapes。
lines array 用于替换现有线条的Map lines。

要在新的 map 元素之间创建 map 链接，你需要将某个元素的 selementid 设置为任意值，然后使用该值在链接的 selementid1 或 selementid2 属性中引用该元素。元素创建后，这个值将被 Zabbix 生成的正确 ID 替换。map.create 示例请参见此处。

返回值

(object) 返回一个 object，其中包含更新后的地图 ID， 这些 ID 位于 sysmapids 属性下。

示例

调整地图尺寸

将地图大小更改为 1200x1200 像素。

执行请求:

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

响应：

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

更改地图所有者

仅对管理员和超级管理员可用。

执行请求:

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

响应：

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

另请参见

来源

CMap::update() 在 ui/include/classes/api/services/CMap.php 中。