event.acknowledge

Описание

object event.acknowledge(параметры объекта/массива)

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

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

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

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

Параметры

(объект/массив) Параметры, которые содержат ID событий и операции обновления, которые необходимо выполнить.

Параметр Тип Описание
eventids
(требуется)		 строка/объект ID подтверждаемых событий.
action
(требуется)		 целое число Действие(я) по обновлению событий. Это поле побитовой маски, принимается любая комбинация значений.

Возможные значения:
1 - закрыть проблемы;
2 - подтвердить событие;
4 - добавить сообщение;
8 - изменить важность.
message строка Текст сообщения.
Требуется, если действие имеет 'добавление сообщения' флаг.
severity целое число Новая важность событиям.
Требуется, если действие содержит 'изменить важность' флаг.

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

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

(object) Возвращает объект, который содержит ID обновленных событий, указанных в свойстве 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.