item.update

Описание

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

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

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

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

Параметры

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

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

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

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

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

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

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

(объект) Возвращает объект, который содержит 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 agent

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

Запрос:

{
    "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.