host.update

Descrizione

object host.update(object/array hosts)

Questo metodo consente di aggiornare host esistenti.

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 Ruoli utente.

Parametri

(object/array) Proprietà del host da aggiornare.

La proprietà hostid deve essere definita per ogni host, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà specificate, tutte le altre rimarranno invariate.

Si noti tuttavia che l'aggiornamento del nome tecnico del host aggiornerà anche il nome visibile del host (se non specificato separatamente) con il valore del nome tecnico del host.

Oltre alle proprietà standard del host, il metodo accetta i seguenti parametri.

Parameter Type Description
groups object/array Gruppi di host per sostituire i gruppi di host correnti a cui il host appartiene.
Tutti i gruppi di host non elencati nella richiesta verranno scollegati.

I gruppi di host devono avere definita solo la proprietà groupid.
interfaces object/array Interfacce del host per sostituire le interfacce correnti del host.
Tutte le interfacce non elencate nella richiesta verranno rimosse.
tags object/array Tag del host per sostituire i tag correnti del host.
Tutti i tag non elencati nella richiesta verranno rimossi.
inventory object Proprietà dell'inventario del host.
macros object/array Macro utente per sostituire le macro utente correnti.
Tutte le macro non elencate nella richiesta verranno rimosse.
templates object/array Template per sostituire i template attualmente collegati.
Tutti i template non elencati nella richiesta verranno solo scollegati.

I template devono avere definita solo la proprietà templateid.
templates_clear object/array Template da scollegare e rimuovere dal host.

I template devono avere definita solo la proprietà templateid.

Valori di ritorno

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

Esempi

Abilitazione di un host

Abilitare il monitoraggio dell'host, ovvero impostarne lo stato a "0".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "status": 0
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10126"
        ]
    },
    "id": 1
}

Abilitazione di più host

Abilitare il monitoraggio di due host, cioè impostare il loro stato su "0".

Request:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": [
        {
            "hostid": "10127",
            "status": 0
        },
        {
            "hostid": "10128",
            "status": 0
        }
    ],
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10127",
            "10128"
        ]
    },
    "id": 1
}

Scollegamento dei template

Scollega e rimuove due template da un host.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "templates_clear": [
            {
                "templateid": "10124"
            },
            {
                "templateid": "10125"
            }
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10126"
        ]
    },
    "id": 1
}

Aggiornamento delle macro dell'host

Sostituisce tutte le macro dell'host con due nuove.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "macros": [
            {
                "macro": "{$PASS}",
                "value": "password"
            },
            {
                "macro": "{$DISC}",
                "value": "sda",
                "description": "Descrizione aggiornata"
            }
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10126"
        ]
    },
    "id": 1
}

Aggiornamento dell'inventario dell'host

Modificare la modalità dell'inventario e aggiungere la posizione

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "inventory_mode": 0,
        "inventory": {
            "location": "Latvia, Riga"
        }
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10387"
        ]
    },
    "id": 1
}

Aggiornamento dei tag del host

Sostituisci tutti i tag del host con uno nuovo.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "tags": {
            "tag": "os",
            "value": "rhel-7"
        }
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10387"
        ]
    },
    "id": 1
}

Aggiornamento delle macro del host individuato

Convertire la macro "automatic" creata dalla regola di individuazione in "manual" e modificarne il valore in "new-value".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "macros": {
            "hostmacroid": "5541",
            "value": "new-value",
            "automatic": "0"
        }
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10387"
        ]
    },
    "id": 1
}

Aggiornamento della crittografia del host

Aggiorna il host "10590" in modo che utilizzi la crittografia PSK solo per le connessioni dal host al server Zabbix e modifica l'identità PSK e la chiave PSK. Si noti che il host deve essere preconfigurato per utilizzare PSK.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10590",
        "tls_connect": 1,
        "tls_accept": 2,
        "tls_psk_identity": "PSK 002",
        "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10590"
        ]
    },
    "id": 1
}

Vedi anche

Fonte

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