event.acknowledge

Опис

object event.acknowledge(object/array parameters)

Цей метод дозволяє оновлювати події. Можна виконати такі дії оновлення:

  • Закрити подію. Якщо подію вже вирішено, цю дію буде пропущено.
  • Підтвердити подію. Якщо подію вже підтверджено, ця дія буде пропущена.
  • Подія непідтвердження. Якщо подію не підтверджено, ця дія буде пропущена.
  • Додати повідомлення.
  • Зміна серйозності події. Якщо подія вже має такий самий рівень серйозності, цю дію буде пропущено.

Можна оновити лише тригерні події.
Лише проблемні події можна оновити.
Щоб закрити подію або змінити серйозність події, потрібні права читання/запису для тригера.
Щоб закрити подію, у тригері має бути дозволено ручне закриття.

Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object/array) Параметри, що містять ідентифікатори подій і операцій оновлення, які слід виконати.

Параметр Тип Опис
eventids
(обов’язково)
рядок/об’єкт Ідентифікатори подій, які потрібно підтвердити.
action
(обов’язково)
ціле Дії оновлення подій. Це поле бітової маски, будь-яка комбінація значень прийнятна.

Можливі значення:
1 - закрити проблему;
2 - підтвердити подію;
4 - додати повідомлення;
8 - змінити серйозність;
16 - подія непідтвердження.
повідомлення рядок Текст повідомлення.
Required, якщо дія містить позначку «додати повідомлення».
серйозність ціле число Новий рівень серйозності для подій.
Required, якщо дія містить позначку «змінити серйозність».

Можливі значення:
0 – не класифікується;
1 – інформація;
2 - попередження;
3 - середній;
4 - високий;
5 - катастрофа.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості eventids.

Приклади

Підтвердження події

Підтвердьте окрему подію та залиште повідомлення.

Запит:

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

Відповідь:

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

Зміна серйозності події

Змініть серйозність для кількох подій і залиште повідомлення.

Запит:

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

Відповідь:

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

Джерело

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