item.update

Описание

объект item.update(объект/массив элементы данных)

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

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

Параметры

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

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

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

Параметр Тип Описание
applications массив ID групп элементов данных, которые заменят текущие группы элементов данных.
preprocessing массив Опции предобработки элемента данных, которые заменят текущие опции предварительной обработки.

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

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

Примеры

Активация элемента данных

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

Запрос:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "10092",
               "status": 0
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "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"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Ответ:

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

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

Активация трапов получения значений элемента данных.

Запрос:

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

Ответ:

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

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

Обновление элемента данных с правилом предобработки "По диапазону".

Запрос:

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

Ответ:

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

Исходный код

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