event.acknowledge

Descrizione

object event.acknowledge(object/array parameters)

Questo metodo consente di aggiornare gli eventi. È possibile eseguire le seguenti azioni di aggiornamento:

  • Chiudere l'evento. Se l'evento è già risolto, questa azione verrà ignorata.
  • Confermare l'evento. Se l'evento è già confermato, questa azione verrà ignorata.
  • Annullare la conferma dell'evento. Se l'evento non è confermato, questa azione verrà ignorata.
  • Aggiungere un messaggio.
  • Modificare la gravità dell'evento. Se l'evento ha già la stessa gravità, questa azione verrà ignorata.
  • Sopprimere l'evento. Se l'evento è già soppresso, questa azione verrà ignorata.
  • Annullare la soppressione dell'evento. Se l'evento non è soppresso, questa azione verrà ignorata.
  • Modificare il rango dell'evento in causa. Se l'evento è già classificato come causa, questa azione verrà ignorata.
  • Modificare il rango dell'evento in sintomo. Se l'evento è già classificato come sintomo, questa azione verrà ignorata.

Possono essere aggiornati solo gli eventi di trigger.
Possono essere aggiornati solo gli eventi problema.
Per chiudere l'evento o modificarne la gravità sono richiesti i diritti di lettura/scrittura per il trigger.
Per chiudere un evento, nel trigger deve essere consentita la chiusura manuale.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object/array) Parametri contenenti gli ID degli eventi e le operazioni di aggiornamento che devono essere eseguite.

Parametro Type Descrizione
eventids ID/array ID degli eventi da riconoscere.

Comportamento del parametro:
- obbligatorio
action integer Azione/i di aggiornamento dell'evento.

Valori bitmap possibili:
1 - chiudi problema;
2 - riconosci evento;
4 - aggiungi messaggio;
8 - cambia gravità;
16 - annulla riconoscimento evento;
32 - sopprimi evento;
64 - annulla soppressione evento;
128 - cambia il rango dell'evento in causa;
256 - cambia il rango dell'evento in sintomo.

Questo è un campo bitmask; è accettata qualsiasi somma dei possibili valori bitmap (ad esempio, 34 per riconoscere e sopprimere un evento).

Comportamento del parametro:
- obbligatorio
cause_eventid ID ID dell'evento causa.

Comportamento del parametro:
- obbligatorio se action contiene il bit "change event rank to symptom"
message string Testo del messaggio.

Comportamento del parametro:
- obbligatorio se action contiene il bit "add message"
severity integer Nuova gravità per gli eventi.

Valori possibili:
0 - non classificato;
1 - informazione;
2 - avviso;
3 - medio;
4 - alto;
5 - disastro.

Comportamento del parametro:
- obbligatorio se action contiene il bit "change severity"
suppress_until integer Timestamp Unix fino al quale l'evento deve essere soppresso.

Se impostato su "0", la soppressione sarà indefinita.

Comportamento del parametro:
- obbligatorio se action contiene il bit "suppress event"

Restituisce i valori

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

Esempi

Riconoscimento di un evento

Riconosci un singolo evento e lascia un messaggio.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problema risolto."
    },
    "id": 1
}

Risposta:

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

Modifica della gravità dell'evento

Modificare la gravità per più eventi e lasciare un messaggio.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Maintenance required to fix it.",
        "severity": 4
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427",
            "20428"
        ]
    },
    "id": 1
}

Fonte

CEvent::acknowledge() in ui/include/classes/api/services/CEvent.php.