Documentation
4.2
Русский
Table of Contents
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
}Copy
✔ Copied
Ответ:
Обновление зависимого элемента данных
Обновление имени и ID основного элемента данных у зависимого элемента данных. Зависимости разрешены только в пределах одного узла сети, поэтому у основного и зависимого элементов данных должен быть одинаковый hostid.
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Copy
✔ Copied
Ответ:
Обновление элемента данных HTTP агент
Активация трапов получения значений элемента данных.
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": "1"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Copy
✔ Copied
Ответ:
Обновление элементы данных с предварительной обработкой
Обновление элемента данных с правилом предобработки "По диапазону".
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": "13",
"params": "\n100",
"error_handler": "1",
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Copy
✔ Copied
Ответ:
Исходный код
CItem::update() в frontends/php/include/classes/api/services/CItem.php.