item.update

Descripció

object item.update(object/array items)

Aquest mètode permet actualitzar elements.

Paràmetres

(object/array) Propietats de l'element a actualitzar.

La propietat itemid s'ha d'establir per a cada element, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les [propietats estàndard de l'element] (object#item), el mètode admet els paràmetres següents.

Valors de retorn

(object) Torna un objecte que contingui els IDs dels elements actualitzats sota la propietat itemids.

Exemples

Activar un element

Activar un element; és a dir, establir el seu estat a "0".

Petició:

{  "jsonrpc": "2.0",  "method": "item.update",  "params": {  "itemid": "10092",  "status": 0  },  "auth": "700ca65537074ec963db7efabda78259",  "id": 1 }

Resposta:

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

Actualitzar un element dependent

Actualitzar el nom de l'element dependent i l'ID de l'element principal. Només es permeten les dependències del mateix equip; per tant, els elements mestre i dependents han de tindre el mateix ID d'equip.

Petició:

{  "jsonrpc": "2.0",  "method": "item.update",  "params": {  "name": "Dependent item updated name",  "master_itemid": "25562",  "itemid": "189019"  },  "auth": "700ca65537074ec963db7efabda78259",  "id": 1 }

Resposta:

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

Actualitzar un element d'agent HTTP

Activar el trap per al valor de l'element.

Petició:

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

Resposta:

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

Actualitzar un element amb preprocessament

Actualitzar un element amb la regla de preprocessament d'element "In range".

Petició:

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

Resposta:

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

Actualitzar un element d'script

Actualitzar un element d'script amb un script diferent, i esborrar els paràmetres obsolets que emprava l'script antic.

Petició:

{  "jsonrpc": "2.0",  "method": "item.update",  "params": {  "itemid": "23865",  "parameters": [],  "script": "Zabbix.Log(3, 'Log test');\nreturn 1;"  },  "auth": "700ca65537074ec963db7efabda78259",  "id": 1 }

Resposta:

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

Font

CItem::update() in ui/include/classes/api/services/CItem.php.