/Methods/DeleteMonitoredEvents

<< Click to Display Table of Contents >>

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

/Methods/DeleteMonitoredEvents

Удаляет выборки из подписки по выданным сервером monitoredItemId.

HTTP: POST /Methods/DeleteMonitoredEvents

Запрос

{
  "sessionId": 123456789,
  "subscriptionId": 1,
  "items": [1, 2]
}

Поля запроса

Поле

Тип

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

Описание

sessionId

integer

условно

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

subscriptionId

integer

да

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

items

array of integer

да

Массив monitoredItemId, полученных от CreateMonitoredEvents

Ответ

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

Поля ответа

Поле

Тип

Описание

subscriptionId

integer

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

serverTime

integer

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

code

integer

Общий результат удаления

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

Если хотя бы один monitoredItemId не найден, метод возвращает OpcUa_BadMonitoredItemIdInvalid в корневом code. Выборки, найденные до или после ошибочного элемента, всё равно удаляются: операция не атомарна.

Поэлементные статусы не возвращаются.

Когда удалена последняя выборка, сервер очищает все накопленные пакеты подписки.

Текущая реализация ожидает массив целых чисел без дополнительной проверки типов; передача другой структуры не является поддержанным контрактом.