map.update

Описание

object map.update(объект/массив maps)

Этот метод позволяет обновлять существующие карты.

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Сопоставление свойств, которые необходимо обновить.

Свойство mapid должно быть определено для каждой карты, все остальные свойства необязательны. Будут обновлены только переданные свойства, все остальные останутся без изменений.

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

Parameter Type Description
links array Ссылки карты для замены существующих ссылок.
selements array Элементы карты для замены существующих элементов.
urls array URL карты для замены существующих URL.
users array Пользователи карты для замены существующих элементов.
userGroups array Группы пользователей карты для замены существующих элементов.
shapes array Фигуры карты для замены существующих фигур.
lines array Линии карты для замены существующих линий.

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

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

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

Примеры

Изменение размера карты

Измените размер карты до 1200x1200 пикселей.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "8",
        "width": 1200,
        "height": 1200
    },
    "id": 1
}

Ответ:

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

Изменение владельца карты

Доступно только администраторам и супер-администраторам.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "9",
        "userid": "1"
    },
    "id": 1
}

Ответ:

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

См. также

Источник

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