Table of Contents
history.get
Beschrijving
integer/array history.get(object parameters)
De methode maakt het mogelijk om historische gegevens op te halen volgens de gegeven parameters.
Zie ook: bekende problemen
Deze methode kan historische gegevens van a . retourneren verwijderde entiteit als deze gegevens niet zijn verwijderd door de huishoudster nog.
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.
Parameters
(object) Parameters die de gewenste uitvoer definiëren.
De methode ondersteunt de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| history | integer | History-objecttypen die moeten worden geretourneerd. Mogelijke waarden: 0 - numeriek zwevend; 1 - teken; 2 - log; 3 - numeriek zonder teken; 4 - tekst. Standaard: 3. |
| hostids | string/array | Retourneer alleen de geschiedenis van de opgegeven hosts. |
| itemids | string/array | Retourneer alleen de geschiedenis van de opgegeven items. |
| time_from | timestamp | Retourneer alleen waarden die na of op het opgegeven tijdstip zijn ontvangen. |
| time_till | timestamp | Retourneer alleen waarden die eerder of op het opgegeven tijdstip zijn ontvangen. |
| sortfield | string/array | Sorteer het resultaat op de gegeven eigenschappen. Mogelijke waarden zijn: itemid en clock. |
| countOutput | boolean | Deze parameters gelden voor alle get-methoden en worden in detail beschreven op de pagina referentiecommentaar. |
| editable | booleaans | |
| excludeSearch | boolean | |
| filter | object | |
| limiet | geheel getal | |
| uitvoer | query | |
| zoeken | object | |
| searchByAny | boolean | |
| searchWildcardsIngeschakeld | boolean | |
| sortorde | string/array | |
| startZoeken | booleaans |
Retourwaarden
(integer/array) Retourneert ofwel:
- een reeks objecten;
- het aantal opgehaalde objecten, als de
countOutputparameter heeft gebruikt.
Voorbeelden
Itemgeschiedenisgegevens ophalen
Retourneer 10 laatste waarden die zijn ontvangen van een numeriek (zwevend) item.
Verzoek:
{
"jsonrpc": "2.0",
"method": "history.get",
"params": {
"output": "extend",
"history": 0,
"itemids": "23296",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 10
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Antwoord:
{
"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
}Bron
CHistory::get() in ui/include/classes/api/services/CHistory.php.