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ść.

Zapytanie:

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

Odpowiedź:

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

Źródło

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