更新

描述

object map.update(object/array maps)

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

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

参数

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

必须为每个拓扑图定义 mapid 属性，其他所有属性均为可选。 只有传入的属性会被更新，其他所有属性将保持不变。

除了标准拓扑图属性外，该方法 还接受以下参数。

参数 类型 说明
links array 用于替换现有链接的拓扑图链接。
selements array 用于替换现有元素的拓扑图元素。
urls array 用于替换现有 URL 的拓扑图 URL。
users array 用于替换现有元素的拓扑图用户共享。
userGroups array 用于替换现有元素的拓扑图用户组共享。
shapes array 用于替换现有形状的拓扑图形状。
lines array 用于替换现有线条的拓扑图线条。

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

返回值

(object) 返回一个对象，该对象包含 sysmapids 属性下更新的映射ID。

案例

调整拓扑图大小

将拓扑图大小更改为 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() in ui/include/classes/api/services/CMap.php.