Documentation
Table of Contents
item.update
Leírás
object item.update(object/array items)
Ez a módszer lehetővé teszi a meglévő elemek frissítését.
A webes elemek nem frissíthetők a Zabbix API-n keresztül.
Ez a módszer csak az Admin és a Kiemelt rendszergazda számára érhető el felhasználói típusok. A metódus meghívására vonatkozó engedélyek felhasználói szerepkörben visszavonhatók beállítások. Lásd: User roles további információért.
Paraméterek
(objektum/tömb) Frissítendő elemtulajdonságok.
Az "itemid" tulajdonságot minden elemhez meg kell határozni, az összes többihez a tulajdonságok nem kötelezőek. Csak az átadott tulajdonságok frissülnek a többi változatlan marad.
A standard item properties mellett a metódus elfogadja a következő paramétereket.
| Paraméter | Típus | Leírás |
|---|---|---|
| preprocessing | array | Elem előfeldolgozása opciók a jelenlegi előfeldolgozási beállítások helyettesítésére. |
| tags | array | Elem címkék. |
Visszatérési értékek
(object) A frissített elemek azonosítóit tartalmazó objektumot ad vissza az itemids tulajdonság alatt.
Példák
Enabling an item
Enable an item, that is, set its status to "0".
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Update dependent item
Update Dependent item name and Master item ID. Only dependencies on same host are allowed, therefore Master and Dependent item should have same hostid.
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Update HTTP agent item
Enable item value trapping.
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Updating an item with preprocessing
Update an item with item preprocessing rule "In range".
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
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:
Forrás
CItem::update() az ui/include/classes/api/services/CItem.php-ban.