integer/array history.get(object parameters)
Метод позволяет получить данные истории по заданным параметрам.
См. также: известные проблемы
Этот метод может возвращать исторические данные удаленного объекта, если эти данные еще не были удалены служебной программой.
Этот метод доступен для пользователей с любыми ролями. Разрешения на вызов метода можно отозвать в настройках роли пользователя. Смотрите Роли пользователя, чтобы получить больше информации.
(object)
Параметры, определяющие желаемый результат.
Метод поддерживает следующие параметры.
Параметр | Тип | Описание |
---|---|---|
history | integer | Типы объектов истории для возврата. Возможные значения: 0 – числовое значение с плавающей запятой; 1 – символ; 2 – журнал; 3 – числовое значение без знака; 4 - текст. По умолчанию: 3. |
hostids | string/array | Возвращает только историю с заданных хостов. |
itemids | string/array | Возвращает только историю из указанных элементов. |
time_from | timestamp | Возвращает только те значения, которые были получены после или в указанное время. |
time_till | timestamp | Возвращает только те значения, которые были получены до или в указанное время. |
sortfield | string/array | Сортировать результат по заданным свойствам. Возможные значения: itemid и clock . |
countOutput | boolean | Эти параметры являются общими для всех методов get и подробно описаны на странице справочный комментарий. |
editable | boolean | |
excludeSearch | boolean | |
filter | object | |
limit | integer | |
output | query | |
search | object | |
searchByAny | boolean | |
searchWildcardsEnabled | boolean | |
sortorder | string/array | |
startSearch | boolean |
(integer/array)
Возвращает:
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.085",
"ns": "563157632"
},
{
"itemid": "23296",
"clock": "1351090936",
"value": "0.16",
"ns": "549216402"
},
{
"itemid": "23296",
"clock": "1351090876",
"value": "0.18",
"ns": "537418114"
},
{
"itemid": "23296",
"clock": "1351090816",
"value": "0.21",
"ns": "522659528"
},
{
"itemid": "23296",
"clock": "1351090756",
"value": "0.215",
"ns": "507809457"
},
{
"itemid": "23296",
"clock": "1351090696",
"value": "0.255",
"ns": "495509699"
},
{
"itemid": "23296",
"clock": "1351090636",
"value": "0.36",
"ns": "477708209"
},
{
"itemid": "23296",
"clock": "1351090576",
"value": "0.375",
"ns": "463251343"
},
{
"itemid": "23296",
"clock": "1351090516",
"value": "0.315",
"ns": "447947017"
},
{
"itemid": "23296",
"clock": "1351090456",
"value": "0.275",
"ns": "435307141"
}
],
"id": 1
}
CHistory::get() в ui/include/classes/api/services/CHistory.php.