获取

描述

integer/array trend.get(object **parameters**)

该方法用于根据指定的参数检索趋势数据。

参数

(object)定义所需输出的参数。 该方法提供以下参数。

参数类型描述
itemidsstring/array仅返回指定监控项ID的趋势。
time_fromtimestamp仅返回指定时间（包含）之后已采集的值。
time_tilltimestamp仅返回指定时间（包含）之前已采集的值。
countOutputboolean计算检索对象的数量。
limitinteger限制检索对象的数量。
outputquery输出设置的字段。

返回值

(integer/array) 返回两者其中任一：

  • 一组对象；

  • 若已使用countOutput参数，则检索对象的计数。

示例

检索监控项趋势数据

请求:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "method": "trend.get",
  4.     "params": {
  5.         "output": [
  6.             "itemid",
  7.             "clock",
  8.             "num",
  9.             "value_min",
  10.             "value_avg",
  11.             "value_max",
  12.         ],
  13.         "itemids": [
  14.             "23715"
  15.         ],
  16.         "limit": "1"
  17.     },
  18.     "auth": "038e1d7b1735c6a5436ee9eae095879e",
  19.     "id": 1
  20. }

响应:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "result": [
  4.         {
  5.             "itemid": "23715",
  6.             "clock": "1446199200",
  7.             "num": "60",
  8.             "value_min": "0.1650",
  9.             "value_avg": "0.2168",
  10.             "value_max": "0.3500",
  11.         }
  12.     ],
  13.     "id": 1
  14. }

来源

CTrend::get() in frontends/php/include/classes/api/services/CTrend.php. CTrend::get()方法可在frontends/php/include/classes/api/services/CTrend.php中参考。