/Methods/RefreshEvents

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > События и сообщения >

/Methods/RefreshEvents

Просматривает известные серверу экземпляры событий и ставит в очередь подписки снимки тех, у которых задано время активации. Снимки проходят через адресацию и фильтры каждой выборки.

HTTP: POST /Methods/RefreshEvents

Запрос

{
  "sessionId": 123456789,
  "subscriptionId": 1
}

Поля запроса

Поле

Тип

Обязательное

Описание

sessionId

integer

условно

Нужен, если сессия не передана заголовком Session-Id

subscriptionId

integer

да

Идентификатор подписки

Ответ

{
  "subscriptionId": 1,
  "serverTime": 1710000000123,
  "code": 0
}

Поля ответа

Поле

Тип

Описание

subscriptionId

integer

Идентификатор подписки

serverTime

integer

Время сервера, Unix time в миллисекундах

code

integer

Результат постановки снимков в очередь

Поведение и ограничения

Метод не возвращает события непосредственно. Их нужно получить последующими вызовами PublishEvents; поле recType таких записей равно Refresh.

Снимок строится синхронным обходом всех экземпляров событий и может добавить несколько пакетов.

Проверяется наличие ActiveTime, а не текущее значение логического поля Active. Деактивированные, но уже когда-либо активировавшиеся экземпляры также могут пройти этот предварительный отбор; затем применяются фильтры выборки.

В отличие от создания/удаления выборок и публикации, текущая реализация не перезапускает таймер активности подписки.