item.update

Descrizione

object item.update(object/array items)

Questo metodo consente di aggiornare item esistenti.

Gli item web non possono essere aggiornati tramite la Zabbix API.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object/array) Proprietà dell'item da aggiornare.

La proprietà itemid deve essere definita per ogni item, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà standard dell'item, il metodo accetta i seguenti parametri.

Parametro Type Descrizione
preprocessing array Opzioni di preprocessing dell'item per sostituire le opzioni di preprocessing correnti.

Comportamento del parametro:
- sola lettura per oggetti ereditati o oggetti individuati
tags array Tag dell'item.

Comportamento del parametro:
- sola lettura per oggetti individuati

Restituisce i valori

(object) Restituisce un oggetto contenente gli ID degli articoli aggiornati sotto la proprietà itemids.

Esempi

Abilitazione di un item

Abilitare un item, ovvero impostarne lo stato a "0".

Richiesta:

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

Risposta:

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

Aggiornare un item dipendente

Aggiorna il nome dell'item dipendente e l'ID dell'item principale. Sono consentite solo dipendenze sullo stesso host, pertanto l'item principale e l'item dipendente devono avere lo stesso hostid.

Request:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Nome aggiornato dell'item dipendente",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "id": 1
}

Response:

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

Aggiornare un item HTTP agent

Abilitare il trapping del valore dell'item.

Richiesta:

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

Risposta:

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

Aggiornamento di un item con preprocessing

Aggiorna un item con la regola di preprocessing dell'item "In range".

Richiesta:

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

Risposta:

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

Aggiornamento di un item script

Aggiornare un item script con uno script diverso e rimuovere i parametri non necessari utilizzati dallo script precedente.

Request:

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

Risposta:

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

Fonte

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