Documentation
Table of Contents
item.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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 Áú»¢¶Ä²©.
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.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(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.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| 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": "Áú»¢¶Ä²©.log(3, 'Log test');\nreturn 1;"
},
"id": 1
}Respuesta:
Fuente
CItem::update() en ui/include/classes/api/services/CItem.php.