Documentation
Table of Contents
map.create
Описание
объект map.create(объект/массив карты)
Этот метод позволяет создавать новые карты сетей.
Параметры
(объект/массив) Создаваемые карты сетей.
В дополнение к стандартным свойствам карты сети, этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| links | массив | Создаваемые связи карты на карте сети. |
| selements | массив | Создаваемые элементы карты на карте сети. |
| urls | массив | Создаваемые URL'ы на карте сети. |
| users | массив | Пользователь карты, которому будет предоставлен общий доступ к карте сети. |
| userGroups | массив | Группа пользователей карты, которой будет предоставлен общий доступ к карте сети. |
Для создания связей на карте сети вам необходимо задать элементам карты произвольное значение 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
}Ответ:
Создание карты сети с узлами сети
Создание карты сети с двумя элементами узлов сети и связи между ними. Обратите внимание на использование временных значений "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
}Ответ:
Общий доступ к карте сети
Создание карты сети с двумя типами общего доступа (пользователю и группе пользователей).
Запрос:
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map sharing",
"width": 600,
"height": 600,
"users": [
{
"userid": "4",
"permission": "3"
}
],
"userGroups": [
{
"usrgrpid": "7",
"permission": "2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Ответ:
Смотрите также
Исходный код
CMap::create() в frontends/php/include/classes/api/services/CMap.php.