更新拓扑图

描述

object map.update(object/array maps)

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

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

参数

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

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

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

参数类型说明
linksarrayMap links 来替换现有的链接。
selementsarrayMap elements 替换现有元素。
urlsarray拓扑图 URLs 以替换现有的 URL。
usersarrayMap user 共享以替换现有元素。
userGroupsarray拓扑图 用户组 共享以替换现有元素。
shapesarrayMap shapes 来替换现有的形状。
linesarrayMap lines 来替换现有的行。

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

返回值

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

案例

调整拓扑大小

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

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "map.update",
  4. "params": {
  5. "sysmapid": "8",
  6. "width": 1200,
  7. "height": 1200
  8. },
  9. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  10. "id": 1
  11. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "sysmapids": [
  5. "8"
  6. ]
  7. },
  8. "id": 1
  9. }

改变拓扑图的拥有者

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

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "map.update",
  4. "params": {
  5. "sysmapid": "9",
  6. "userid": "1"
  7. },
  8. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  9. "id": 2
  10. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "sysmapids": [
  5. "9"
  6. ]
  7. },
  8. "id": 2
  9. }

查看相关

来源

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