event.acknowledge

Описание

object event.acknowledge(object/array parameters)

Этот метод позволяет обновлять события. Можно выполнить следующие действия по обновлению:

  • Закрыть событие. Если событие уже устранено, это действие будет пропущено.
  • Подтвердить событие. Если событие уже подтверждено, это действие будет пропущено.
  • Снять подтверждение события. Если событие не подтверждено, это действие будет пропущено.
  • Добавить сообщение.
  • Изменить важность события. Если у события уже такая же важность, это действие будет пропущено.
  • Подавить событие. Если событие уже подавлено, это действие будет пропущено.
  • Снять подавление события. Если событие не подавлено, это действие будет пропущено.
  • Изменить ранг события на причину. Если событие уже имеет ранг причины, это действие будет пропущено.
  • Изменить ранг события на симптом. Если событие уже имеет ранг симптома, это действие будет пропущено.

Обновлять можно только события триггеров.
Обновлять можно только события проблем.
Для закрытия события или изменения важности события необходимы права чтения/записи для триггера.
Чтобы закрыть событие, в триггере должно быть разрешено ручное закрытие.

Этот метод доступен пользователям любого типа. Права на вызов метода могут быть отозваны в настройках роли пользователя. Подробнее см. в разделе Роли пользователей.

Параметры

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

Параметр Type Описание
eventids ID/array Идентификаторы событий, которые необходимо подтвердить.

Поведение параметра:
- обязательный
action integer Действие(я) обновления события.

Возможные значения битовой маски:
1 - закрыть проблему;
2 - подтвердить событие;
4 - добавить сообщение;
8 - изменить важность;
16 - снять подтверждение события;
32 - подавить событие;
64 - снять подавление события;
128 - изменить ранг события на причину;
256 - изменить ранг события на симптом.

Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 34 для подтверждения и подавления события).

Поведение параметра:
- обязательный
cause_eventid ID ID события-причины.

Поведение параметра:
- обязательный, если action содержит бит "change event rank to symptom"
message string Текст сообщения.

Поведение параметра:
- обязательный, если action содержит бит "add message"
severity integer Новая важность для событий.

Возможные значения:
0 - не классифицировано;
1 - информация;
2 - предупреждение;
3 - средняя;
4 - высокая;
5 - катастрофа.

Поведение параметра:
- обязательный, если action содержит бит "change severity"
suppress_until integer Unix timestamp, до которого событие должно быть подавлено.

Если установлено значение "0", подавление будет бессрочным.

Поведение параметра:
- обязательный, если action содержит бит "suppress event"

Возвращаемые значения

(object) Возвращает объект, который содержит ID обновленных событий, указанных в свойстве eventids.

Примеры

Подтверждение события

Подтвердите одно событие и оставьте сообщение.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Проблема устранена."
    },
    "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
    },
    "id": 1
}

Ответ:

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

Источник

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