map.create

Описание

объект map.create(объект/массив карты)

Этот метод позволяет создавать новые карты сетей.

Параметры

(объект/массив) Создаваемые карты сетей.

В дополнение к стандартным свойствам карты сети, этот метод принимает следующие параметры.

Параметр Тип Описание
links массив Создаваемые связи карты на карте сети.
selements массив Создаваемые элементы карты на карте сети.
urls массив Создаваемые URL'ы на карте сети.

Для создания связей на карте сети вам необходимо задать элементам карты произвольное значение selementid и затем использовать это значение для ссылки на этот элемент в свойствах связи selementid1 или selementid2. Когда элемент будет создан, это значение заменится корректным ID, который сгенерирует Zabbix. Смотрите пример.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных карт сетей под свойством sysmapids. Порядок возвращаемых ID совпадает с порядком переданных карт сетей.

Примеры

Создание пустой карты сети

Создание карты сети без элементов.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map",
               "width": 600,
               "height": 600
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Ответ:

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

Создание карты сети с узлами сети

Создание карты сети с двумя элементами узлов сети и связи между ними. Обратите внимание на использование временных значений "selementid1" и "selementid2" в объекте связи на карте для ссылки на элементы карты.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Host map",
               "width": 600,
               "height": 600,
               "selements": [
                   {
                       "elementid": "1033",
                       "selementid": "1",
                       "elementtype": 0,
                       "iconid_off": "2"
                   },
                   {
                       "elementid": "1037",
                       "selementid": "2",
                       "elementtype": 0,
                       "iconid_off": "2"
                   }
               ],
               "links": [
                   {
                       "selementid1": "1",
                       "selementid2": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Ответ:

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

Смотрите также

Исходный код

CMap::create() в frontends/php/include/classes/api/services/CMap.php.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.