Table of Contents
item.update
Descripción
object item.update(object/array items)
Este método permite actualizar métricas existentes.
Las métricas web no pueden actualizarse a través de la API de Zabbix.
Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.
Parámetros
(objeto/array) Propiedades de la métrica que se van a actualizar.
La propiedad itemid debe definirse para cada métrica, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.
Además de las propiedades estándar de la métrica, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| preprocessing | array | Opciones de preprocesamiento de la métrica para reemplazar las opciones de preprocesamiento actuales. Comportamiento del parámetro: - solo lectura para objetos heredados u objetos descubiertos |
| tags | array | Etiquetas de la métrica. Comportamiento del parámetro: - solo lectura para objetos descubiertos |
Valores de retorno
(object) Devuelve un objeto que contiene los IDs de las métricas actualizadas bajo la propiedad itemids.
Ejemplos
Habilitar una métrica
Habilite una métrica, es decir, establezca su estado en "0".
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"id": 1
}Respuesta:
Actualizar métrica dependiente
Actualiza el nombre de la métrica dependiente y el ID de la métrica principal. Solo se permiten dependencias en el mismo equipo, por lo tanto, la métrica principal y la dependiente deben tener el mismo hostid.
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Nombre actualizado de la métrica dependiente",
"master_itemid": "25562",
"itemid": "189019"
},
"id": 1
}Respuesta:
Actualizar métrica de agente HTTP
Habilitar la captura de valores de la métrica.
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"id": 1
}Respuesta:
Actualizar una métrica con preprocesamiento
Actualizar una métrica con la regla de preprocesamiento "En rango".
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"id": 1
}Respuesta:
Actualizar una métrica de script
Actualice una métrica de script con un script diferente y elimine los parámetros innecesarios que fueron utilizados por el script anterior.
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.log(3, 'Log test');\nreturn 1;"
},
"id": 1
}Respuesta:
Fuente
CItem::update() en ui/include/classes/api/services/CItem.php.