history.get

Описание

целое число/массив history.get(объект параметры)

Этот метод позволяет получать данные истории в соответствии с заданными параметрами.

Этот метод может вернуть данные истории по удалённым объектами, если эти данные ещё не удалены процессом очистки истории.

Параметры

(объект) Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

Параметр	Тип	Описание
history	целое число	Возвращаемый тип объектов истории. Возможные значения: 0 - число с плавающей точкой; 1 - символ; 2 - журнал (лог); 3 - целое положительное число; 4 - текст. По умолчанию: 3.
hostids	строка/массив	Возврат истории только с заданных узлов сети.
itemids	строка/массив	Возврат истории только с заданных элементов данных.
time_from	штамп времени	Возврат только тех значений, которые были получены после или в заданное время.
time_till	штамп времени	Возврат только тех значений, которые были получены до или в заданное время.
sortfield	строка/массив	Сортировка результата в соответствии с заданными свойствами. Возможные значения: `itemid` и `clock`.
countOutput	флаг	Эти параметры являются общими для всех методов `get` и они описаны в справочных комментариях.
editable	логический
excludeSearch	флаг
filter	объект
limit	целое число
output	запрос
search	объект
searchByAny	логический
searchWildcardsEnabled	логический
sortorder	строка/массив
startSearch	флаг

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

(целое число/массив) Возвращает либо:

массив объектов;
количество найденных объектов, если используется параметр countOutput.

Примеры

Получение данных истории элемента данных

Получение 10 последних значений полученных от числового (с плавающей точкой) элемента данных.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "history.get",
           "params": {
               "output": "extend",
               "history": 0,
               "itemids": "23296",
               "sortfield": "clock",
               "sortorder": "DESC",
               "limit": 10
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "23296",
                   "clock": "1351090996",
                   "value": "0.0850",
                   "ns": "563157632"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090936",
                   "value": "0.1600",
                   "ns": "549216402"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090876",
                   "value": "0.1800",
                   "ns": "537418114"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090816",
                   "value": "0.2100",
                   "ns": "522659528"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090756",
                   "value": "0.2150",
                   "ns": "507809457"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090696",
                   "value": "0.2550",
                   "ns": "495509699"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090636",
                   "value": "0.3600",
                   "ns": "477708209"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090576",
                   "value": "0.3750",
                   "ns": "463251343"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090516",
                   "value": "0.3150",
                   "ns": "447947017"
               },
               {
                   "itemid": "23296",
                   "clock": "1351090456",
                   "value": "0.2750",
                   "ns": "435307141"
               }
           ],
           "id": 1
       }

Исходный код

CHistory::get() в frontends/php/include/classes/api/services/CHistory.php.

Documentation