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

(object/array) Propiedades del item que se actualizarán.

La propiedad itemid debe estar definida para cada item, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

Además de las propiedades estándar del item, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
preprocessing array Opciones de preprocesamiento del item para reemplazar las opciones de preprocesamiento actuales.

Comportamiento del parámetro:
- sólo lectura para objetos heredados u objetos descubiertos
tags array Etiquetas del item.

Comportamiento del parámetro:
- sólo 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".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10092"
        ]
    },
    "id": 1
}

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.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "189019"
        ]
    },
    "id": 1
}

Actualizar métrica de agente HTTP

Habilite la captura de valor de la métrica.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": 1
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Actualización de una métrica con preprocesamiento

Actualice una métrica con la regla de preprocesamiento de métricas "Dentro del rango".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "preprocessing": [
            {
                "type": 13,
                "params": "\n100",
                "error_handler": 1,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Actualizar un item de script

Actualiza un item de script con un script diferente y elimina los parámetros innecesarios que fueron utilizados por el script anterior.

Request:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23865",
        "parameters": [],
        "params": "Zabbix.log(3, 'Log test');\nreturn 1;"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23865"
        ]
    },
    "id": 1
}

Fuente

CItem::update() en ui/include/classes/api/services/CItem.php.