event.acknowledge

Opis

object event.acknowledge(object/array parameters)

Ta metoda pozwala na aktualizację zdarzeń. Można wykonać następujące akcje aktualizacji:

Zamknij zdarzenie. Jeżeli zdarzenie zostało już zamknięte, czynność ta zostanie pominięta.
Potwierdź zdarzenie. Jeśli zdarzenie zostało już potwierdzone, czynność ta zostanie pominięta.
Cofnięcie potwierdzenia zdarzenia. Jeśli zdarzenie jest niepotwierdzone, czynność ta zostanie pominięta.
Dodanie wiadomości.
Zmiana poziomu zdarzenia. Jeśli zdarzenie posiada ten sam poziom, czynność ta zostanie pominięta.

Można aktualizować tylko zdarzenia wyzwalaczy.
Tylko zdarzenia powodujące problemy mogą być aktualizowane.
Uprawnienia do odczytu/zapisu dla wyzwalacza są wymagane do zamknięcia zdarzenia lub zmiany jego poziomu. Aby zamknąć zdarzenie, w wyzwalaczu należy zezwolić na ręczne zamknięcie.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika po więcej informacji.

Parametry

(object/array) Parametry zawierające ID i operacje aktualizacji, które należy wykonać.

Parametr	Typ	Opis
eventids (wymagane)	string/object	Identyfikatory zdarzeń do potwierdzenia.
action (wymagane)	integer	Akcja aktualizacji zdarzenia. To jest pole maski bitowej, dopuszczalna jest dowolna kombinacja wartości. Możliwe wartości: 1 - zamknij problem; 2 - potwierdź zdarzenie; 4 - dodaj wiadomość; 8 - zmień poziom; 16 - cofnięcie potwierdzenia zdarzenia.
message	string	Tekst wiadomości. Wymagane, jeśli akcja zawiera flagę 'add message'.
severity	integer	Nowy poziom dla zdarzeń. Wymagane, jeśli akcja zawiera flagę 'change severity'. Możliwe wartości: 0 — niesklasyfikowany; 1 — informacja; 2 - ostrzeżenie; 3 - średni; 4 - wysoki; 5 - katastrofa.

Zwracane wartości

(object) Zwraca obiekt zawierający ID zaktualizowanych zdarzeń we właściwości eventids.

Przykłady

Potwierdzanie zdarzenia

Potwierdź pojedyncze zdarzenie i zostaw wiadomość.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": "20427",
               "action": 6,
               "message": "Problem resolved."
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowiedź:

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

Zmiana poziomu zdarzeń

Zmień poziom dla wielu zdarzeń i zostaw wiadomość.