usermacro.update

Descrizione

object usermacro.update(object/array hostMacros)

Questo metodo consente di aggiornare le macro del 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à della macro del host da aggiornare.

La proprietà hostmacroid deve essere definita per ciascuna macro del host, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Valori restituiti

"(object)" Restituisce un oggetto contenente gli ID delle macro host aggiornate sotto la proprietà "hostmacroids".

Esempi

Modifica del valore di una macro host

Modificare il valore di una macro host in "public".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "usermacro.update",
    "params": {
        "hostmacroid": "1",
        "value": "public"
    },
    "id": 1
}

Risposta:

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

Modificare il valore della macro creata da una regola di discovery

Convertire la macro "automatica" creata dalla regola di discovery in "manuale" e modificarne il valore in "new-value".

Request:

{
    "jsonrpc": "2.0",
    "method": "usermacro.update",
    "params": {
        "hostmacroid": "1",
        "value": "new-value",
        "automatic": "0"
    },
    "id": 1
}

Risposta:

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

Fonte

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