trend.get

Beschreibung

integer/array trend.get(object parameters)

Mit dieser Methode können Sie Trenddaten entsprechend den angegebenen Parametern abrufen.

Diese Methode steht Benutzern jeden Typs zur Verfügung. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Typ Beschreibung
itemids ID/array Gibt nur Trends mit den angegebenen Datenpunkt-IDs zurück.
time_from timestamp Gibt nur Werte zurück, die nach oder zum angegebenen Zeitpunkt erfasst wurden.
time_till timestamp Gibt nur Werte zurück, die vor oder zum angegebenen Zeitpunkt erfasst wurden.
countOutput boolean Zählt die Anzahl der abgerufenen Objekte.
limit integer Begrenzt die Anzahl der abgerufenen Objekte.
output query Legt die Eigenschaften des Trend-Objekts fest, die zurückgegeben werden sollen.

Rückgabewerte

(integer/array) Gibt entweder Folgendes zurück:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Abrufen von Datenpunkt-Trenddaten

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "trend.get",
    "params": {
        "output": [
            "itemid",
            "clock",
            "num",
            "value_min",
            "value_avg",
            "value_max"
        ],
        "itemids": [
            "23715"
        ],
        "limit": "1"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "23715",
            "clock": "1446199200",
            "num": "60",
            "value_min": "0.165",
            "value_avg": "0.2168",
            "value_max": "0.35"
        }
    ],
    "id": 1
}

Quelle

CTrend::get() in ui/include/classes/api/services/CTrend.php.