Zabbix Documentation 5.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


ru:manual:api:reference:map:update

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

ru:manual:api:reference:map:update [2019/10/07 06:35] (current)
Line 1: Line 1:
 +===== map.update =====
  
 +==== Описание ====
 +
 +''​объект map.update(объект/​массив **карты**)''​
 +
 +Этот метод позволяет обновлять существующие карты сетей.
 +
 +==== Параметры ====
 +
 +''​(объект/​массив)''​ Свойства карт сетей, которые будут обновлены.
 +
 +Свойство ''​mapid''​ должно быть указано по каждой карте сети, все остальные свойства опциональны. Будут обновлены только переданные свойства,​ все остальные останутся неизменными.
 +
 +В дополнение к [[object#​карта_сети|стандартным свойствам карты сети]], этот метод принимает следующие параметры.
 +
 +^ Параметр ^ Тип ^ Описание ^
 +| links | массив | Связи карты, которые заменят текущие связи. |
 +| selements | массив | Элементы карты, которые заменят текущие элементы. |
 +| urls | массив | URL'ы карты, которые заменят текущие URL'​ы. |
 +| users | массив | Пользователь карты, который заменит существующие разрешения на общий доступ к карте сети. |
 +| userGroups | массив | Группа пользователей карты, которая заменит существующие разрешения на общий доступ к карте сети. |
 +| shapes | массив | Фигуры карты, которые заменят текущие фигуры. |
 +| lines | массив | Линии карты, которые заменят текущие линии. |
 +
 +<note tip>​Для создания связей на карте сети вам необходимо задать элементам карты произвольное значение ''​selementid''​ и затем использовать это значение для ссылки на этот элемент в свойствах связи ''​selementid1''​ или ''​selementid2''​. Когда элемент будет создан,​ это значение заменится корректным ID, который сгенерирует Zabbix. [[create#​создание_карты_сети_с_узлами_сети|Смотрите пример для map.create]].</​note>​
 +
 +==== Возвращаемые значения ====
 +
 +''​(объект)''​ Возвращает объект,​ который содержит ID обновленных карт сетей под свойством ''​sysmapids''​.
 +
 +==== Примеры ====
 +
 +=== Изменение размера карты сети ===
 +
 +Изменение размера карты сети на 1200x1200 пикселей.
 +
 +Запрос:​
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​map.update",​
 +    "​params":​ {
 +        "​sysmapid":​ "​8",​
 +        "​width":​ 1200,
 +        "​height":​ 1200
 +    },
 +    "​auth":​ "​038e1d7b1735c6a5436ee9eae095879e",​
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +Ответ:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ {
 +        "​sysmapids":​ [
 +            "​8"​
 +        ]
 +    },
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +=== Изменение владельца карты ===
 +
 +Доступно только администраторам и супер-администраторам.
 +
 +Запрос:​
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​map.update",​
 +    "​params":​ {
 +        "​sysmapid":​ "​9",​
 +        "​userid":​ "​1"​
 +    },
 +    "​auth":​ "​038e1d7b1735c6a5436ee9eae095879e",​
 +    "​id":​ 2
 +}
 +</​code>​
 +
 +Ответ:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ {
 +        "​sysmapids":​ [
 +            "​9"​
 +        ]
 +    },
 +    "​id":​ 2
 +}
 +</​code>​
 +
 +==== Смотрите также ====
 +
 +  * [[object#​элемент_карты|Элемент карты]]
 +  * [[object#​связь_карты|Связь карты]]
 +  * [[object#​url_карты|URL карты]]
 +  * [[object#​пользователь_карты|Пользователь карты]]
 +  * [[object#​группа_пользователей_карты|Группа пользователей карты]]
 +  * [[object#​фигуры_карты|Фигура карты]]
 +  * [[object#​линии_карты|Линия карты]]
 +
 +==== Исходный код ====
 +
 +CMap::​update() в //​frontends/​php/​include/​classes/​api/​services/​CMap.php//​.