ru:manual:api:reference:map:update
Differences
This shows you the differences between two versions of the page.
| — |
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//. | ||