IoT Time Series Aggregates Service – 请求参数
间隔时长
性能实体
仅支持预先计算的间隔时长。请选择一个预先计算的间隔时长的精确倍数,例如10分钟、2小时、5天、3周或2个月。
开始时间和结束时间精度
如果仅提供了参数开始时间和结束时间,但不符合所使用的间隔的预先计算的间隔边界,则对开始时间和结束时间进行平移,使整个时间范围包含所提供的时间范围,且时间范围边界与间隔边界重合。例如,请求的开始时间为 2020-01-10T01:10:00Z
,结束时间为2020-01-10T02:50:00Z
,间隔时间为1小时
。此处开始时间和结束时间与_hour_边界不一致,因此将其调整为附近的_hour_边界,即开始时间2020-01-10T01Z
和结束时间2020-01-10T03Z
。
自动间隔时长计算
如果没有提供间隔时长,则选择符合所用时间范围的最大可用间隔长度。例如,请求的开始时间为2020-01-10T01:10:00Z
,结束时间为2020-01-10T01:20:00Z
。这里间隔时长是使用提供的开始和结束时间自动计算。由于开始时间和结束时间的差值小于1小时,因此间隔时长计算为2分钟
。
参数 count
参数 count
: 用例 1
如果提供了间隔时长和计数,则再提供开始时间或结束时参数间就足够。缺失的参数是根据间隔时长和计数计算的时间范围确定的。例如,请求的开始时间为2020-01-10T01:00:00Z
,间隔长度为1小时
,计数为4
。这里在开始时间2020-01-10T01:00:00Z
和结束时间2020-01-10T05:00:00Z
之间返回4个1小时的聚合。
参数 count
: 用例 2
如果提供了from
,to
和count
, intervalUnit
和intervalValue
则根据时间范围除以count
确定。例如,请求的开始时间为2020-01-10T01:00:00Z
,结束时间为2020-01-10T02:00:00Z
,计数为3
。这里开始时间和结束时间的区别是24小时,并且请求3个聚合响应,因此返回的间隔时长是8小时
。
参数 select
有个可选的select
参数,它定义了要返回的数据。更多信息,请参考 IoT Time Series Aggregates Service-Selecting。
还有问题?
除非另行声明,该网站内容遵循MindSphere开发许可协议.