Documentation
Table of Contents
item.update
Descripció
object item.update(object/array items)
Aquest mètode permet actualitzar elements.
Els elements Web no es poden actualitzar emprant l'API Zabbix.
Tenim aquest mètode disponible només per als usuaris Admin i Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.
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.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| preprocessing | array | Preprocessament de l'element per anul·lar les opcions de preprocessament actuals. |
| tags | array | Etiquetes de l'element. |
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:
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:
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:
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:
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:
Font
CItem::update() in ui/include/classes/api/services/CItem.php.