item.update

Описание

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

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

Веб элементы данных нельзя обновлять через Zabbix API.

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

Параметры

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

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

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

Parameter Type Description
preprocessing array Параметры предобработки элемента данных для замены текущих параметров предобработки.

Поведение параметра:
- read-only для унаследованных объектов или обнаруженных объектов
tags array Теги элемента данных.

Поведение параметра:
- read-only для обнаруженных объектов

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

(объект) Возвращает объект, который содержит ID обновленных элементов данных, указанных в свойстве itemids.

Примеры

Включение элемента данных

Включите элемент данных, то есть установите для его статуса значение "0".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10092"
        ]
    },
    "id": 1
}

Обновление зависимого элемента данных

Обновите имя зависимого элемента данных и ID основного элемента данных. Допускаются только зависимости на одном и том же узле сети, поэтому основной и зависимый элемент данных должны иметь одинаковый hostid.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "189019"
        ]
    },
    "id": 1
}

Обновление элемента данных HTTP-агента

Включить перехват значений элемента данных.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": 1
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Обновление элемента данных с предварительной обработкой

Обновите элемент данных с правилом предварительной обработки элемента данных "In range".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "preprocessing": [
            {
                "type": 13,
                "params": "\n100",
                "error_handler": 1,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Обновление элемента данных типа скрипт

Обновите элемент данных типа скрипт, указав другой скрипт, и удалите ненужные параметры, которые использовались предыдущим скриптом.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23865",
        "parameters": [],
        "params": "Zabbix.log(3, 'Log test');\nreturn 1;"
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23865"
        ]
    },
    "id": 1
}

Источник

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