itemprototype.update

Descripción

object itemprototype.update(object/array itemPrototypes)

Este método permite actualizar prototipos de item existentes.

Parámetros

(object/array) Item prototype properties to be updated.

La propiedad itemid debe definirse para cada prototipo de item, 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 de standard item prototypeproperties, el método acepta los siguientes parámetros.

Valores de retorno

(object) Devuelve un objeto que contiene los ID de los prototipos de item actualizados bajo la propiedad itemids.

Ejemplos

Cambiar la interfaz de un prototipo de item

Cambie la interfaz del host que utilizarán los items descubiertos.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "27428",
        "interfaceid": "132"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Respuesta:

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

Actualizar el prototipo de de item dependiente

Actualice el prototipo de item dependiente con el nuevo ID del prototipo de item Principal. Solo se permiten dependencias en el mismo host (template/discovery rule), por lo tanto, los items principal y dependiente deben tener el mismo ID de host e ID de regla.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "master_itemid": "25570",
        "itemid": "189030"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Respuesta:

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

Actualizar el prototipo de métrica del agente HTTP

Cambie los campos de consulta y elimine todos los encabezados personalizados.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid":"28305",
        "query_fields": [
            {
                "random": "qwertyuiopasdfghjklzxcvbnm"
            }
        ],
        "headers": []
    }
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Respuesta:

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

Actualización de opciones de preprocesamiento de items

Actualizar un prototipo de item con la regla de preprocesamiento de item "multiplicador personalizado".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "44211",
        "preprocessing": [
            {
                "type": 1,
                "params": "4",
                "error_handler": 2,
                "error_handler_params": "5"
            }
        ]
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "44211"
        ]
    },
    "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": "itemprototype.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

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