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.