trend.get

Descrizione

integer/array trend.get(object parameters)

Questo metodo consente di recuperare i dati di trend in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
itemids ID/array Restituisce solo i trend con gli ID item specificati.
time_from timestamp Restituisce solo i valori raccolti dopo o al momento specificato.
time_till timestamp Restituisce solo i valori raccolti prima o al momento specificato.
countOutput boolean Conta il numero di oggetti recuperati.
limit integer Limita il numero di oggetti recuperati.
output query Imposta le proprietà dell'oggetto Trend da restituire.

Valori restituiti

(integer/array) Restituisce o:

  • una matrice di oggetti;
  • il conteggio degli oggetti recuperati, se il parametro countOutput è stato usato.

Esempi

Recupero dei dati di trend degli item

Richiesta:

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

Risposta:

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

Fonte

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