item.actualización
Descripción
object item.update(object/array items)
Este método permite actualizar items existentes.
Los elementos 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 activar el método se pueden revocar en el rol de ajustes de usuario. Ver Usuario roles para más información.
Parámetros
(objeto/matriz) Propiedades del elemento que se actualizarán.
La propiedad itemid debe definirse para cada elemento, todas las demás
propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas
otras permanecerán sin cambios.
Además de las standard item properties, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| preprocesamiento | array | Opciones de Item preprocessing para reemplazar las opciones de preprocesamiento actuales. |
| etiquetas | matriz | Item etiquetas. |
Valores devueltos
(object) Devuelve un objeto que contiene los ID de los items actualizados
bajo la propiedad itemids.
Ejemplos
Habilitar un item
Habilitar un item, es decir, establecer su estado en "0".
Solicitud:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"10092"
]
},
"id": 1
}Actualizar item dependiente
Actualice el nombre del item Dependiente y el ID del item Master. Solo dependencias del mismo host están permitidas, por lo tanto, el item Master y Dependiente deben tener el mismo hostid.
Solicitud:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"189019"
]
},
"id": 1
}Actualizar item del agente HTTP
Habilite la captura de valor de item.
Solicitud:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23856"
]
},
"id": 1
}Reemplazar interfaces de host
Reemplazar todas las interfaces de host por una única interfaz de agente.
Solicitud:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23856"
]
},
"id": 1
}Actualización de un item de secuencia de comandos
Actualice un item de secuencia de comandos con una secuencia de comandos diferente y elimine los parámetros innecesarios que utilizó la secuencia de comandos anterior.
Solicitud:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23865"
]
},
"id": 1
}Fuente
CItem::update() en ui/include/classes/api/services/CItem.php.