trend.get

Description

integer/array trend.get(object parameters)

Cette méthode permet de récupérer les données de tendances selon les paramètres fournis.

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d’informations.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre Type Description
itemids ID/array Retourner uniquement les tendances avec les ID d’élément donnés.
time_from timestamp Retourner uniquement les valeurs qui ont été collectées après ou à l’heure indiquée.
time_till timestamp Retourner uniquement les valeurs qui ont été collectées avant ou à l’heure indiquée.
countOutput boolean Compter le nombre d’objets récupérés.
limit integer Limiter le nombre d’objets récupérés.
output query Définir les propriétés de l’objet Trend à retourner.

Valeurs retournées

(integer/array) Retourne soit :

  • un tableau d'objets ;
  • le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupération des données de tendance d’un élément

Requête:

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

Réponse :

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

Source

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