Documentation
Table of Contents
item.update
Описание
object item.update(объект/массив items)
Этот метод позволяет обновлять существующие элементы данных.
Веб элементы данных нельзя обновлять через Zabbix API.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(объект/массив) Свойства элементов данных, которые будут обновлены.
Свойство itemid должно быть указано по каждому элементу данных, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.
В дополнение к стандартным свойствам элемента данных, этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| applications | массив | ID групп элементов данных, которые заменят текущие группы элементов данных. |
| preprocessing | массив | Опции предобработки элемента данных, которые заменят текущие опции предварительной обработки. |
Возвращаемые значения
(объект) Возвращает объект, который содержит ID обновленных элементов данных, указанных в свойстве itemids.
Примеры
Включение элемента данных
Включить элемент данных, то есть установить его статус в значение "0".
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"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
}Ответ:
Обновить элемент данных HTTP-агента
Включить захват значения элемента данных.
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Ответ:
Обновление элемента данных с предварительной обработкой
Обновить элемент данных с помощью правила предварительной обработки элемента данных "In range".
Запрос:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Ответ:
Updating a script item
Update a script item with a different script and remove unnecessary parameters that were used by previous script.
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Источник
CItem::update() в ui/include/classes/api/services/CItem.php.