trend.get

Descripción

integer/array trend.get(object parameters)

El método permite recuperar datos de tendencias de acuerdo con los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se puede revocar en la configuración de roles de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
itemids cadena/matriz Devuelve solo tendencias con los ID de métricas dados.
time_from marca de tiempo Devuelve solo los valores que se han recopilado después o en el momento dado.
time_till marca de tiempo Devuelve solo los valores que se han recopilado antes o en el momento dado.
countOutput booleano Cuenta el número de objetos recuperados.
limit entero Limita la cantidad de objetos recuperados.
output consulta Establecer campos como salida.

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperando datos de tendencias de artículos

Solicitud:

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

Respuesta:

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

Fuente

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