map.update

Описание

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

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

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

Параметры

(object/array) Свойства карты для обновления.

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

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

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

Чтобы создать связи карты между новыми элементами карты, необходимо установить selementid элемента в произвольное значение, а затем использовать это значение для ссылки на данный элемент в свойствах связей selementid1 или selementid2. Когда элемент будет создан, это значение будет заменено на корректный идентификатор, сгенерированный 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.