Documentation
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 se pueden actualizar a través de la API de Zabbix.
Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para más información.
Parámetros
(objeto/matriz) Propiedades de la métrica que se actualizarán.
La propiedad itemid debe definirse para cada métrica, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las otras permanecerán sin cambios.
Además de las [propiedades estándar de la métrica] (object#item), el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| preprocessing | array | Opciones de Preprocesamiento de métricas para reemplazar las opciones de preprocesamiento actuales. Comportamiento de parámetros: - solo lectura para objetos heredados u objetos descubiertos |
| tags | matriz | Etiquetas de métrica. Comportamiento de parámetros: - solo lectura para objetos descubiertos |
Valores devueltos
(object) Devuelve un objeto que contiene los ID 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
Actualice el nombre de la métrica dependiente y el ID de la métrica principal. Solo están permitidas dependencias del 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": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"id": 1
}Respuesta:
Actualizar métrica de agente HTTP
Habilite la captura de valor de la métrica.
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"id": 1
}Respuesta:
Actualización de una métrica con preprocesamiento
Actualice una métrica con la regla de preprocesamiento de métricas "Dentro del rango".
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"id": 1
}Respuesta:
Actualización de una métrica de script
Actualice una métrica de script con una secuencia de comandos diferente y elimine los parámetros innecesarios que utilizó la secuencia de comandos 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.