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。