item.update
Опис
object item.update(object/array items)
Овај метод вам омогућава да ажурирате постојеће ставке.
::: ::: noteclassic Веб ставке се не могу ажурирати преко Zabbix API-ја. :::
Овај метод је доступан само за Администратор и Супер администратор типове корисника. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.
Параметри
(object/array) Својства ставке која се ажурирају.
Својство itemid мора бити дефинисано за сваку ставку, сва остала
својства су опциона. Биће ажурирана само прослеђена својства, сва
друга ће остати непромењена.
Поред стандардних својстава ставке, метод прихвата следеће параметре.
| Parameter | Type | Description |
|---|---|---|
| preprocessing | array | Предобрада ставке опције за замену тренутних опција за предобраду. Понашање параметра: -само за читање за наслеђене објекте или откривене објекте |
| tags | array | Ознаке ставки. Понашање параметра: - само за читање за откривене објекте |
Повратне вредности
(object) Враћа објекат који садржи 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
}
Ажурирање ставке са претходном обрадом
Ажурирајте ставку правилом за предобраду "У опсегу".
{
"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": [],
"script": "Zabbix.log(3, 'Log test');\nreturn 1;"
},
"id": 1
}
Одговор:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23865"
]
},
"id": 1
}
Извор
CItem::update() in ui/include/classes/api/services/CItem.php.