Sidebar
ru:manual:api:reference:history:get
Table of Contents
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.