IoT物联网-查询设备历史数据:请求参数

时间:2025-02-12 14:52:30

请求参数

参数

必选/可选

类型

位置

描述

app_key

必选

String

header

访问 物联网平台 的应用ID,在物联网平台创建应用时由平台分配获得。

Authorization

必选

String

header

访问物联网平台的认证信息,值为“Bearer {accessToken}”,其中{accessToken}为调用鉴权接口返回的accessToken。

appId

可选

String

query

设备所属的应用ID,当查询授权应用下设备的历史数据时才需要填写。

deviceId

必选

String

query

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

gatewayId

必选

String

query

网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。

pageNo

可选

Integer

query

分页查询参数,查询结果分页显示时指定要查看的页信息,默认0,查询第一页,建议通过设置pageNo和pageSize做分页查询。

pageSize

可选

Integer

query

分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16Mb,同时根据单次查询返回的包大小以及网络带宽设置合理的超时时间。

startTime

可选

String

query

查询产生时间在startTime之后的历史数据。需要填写UTC时间,格式:yyyyMMdd'T'HHmmss'Z',如 20151212T121212Z。

您需要根据本地所在时区自己进行时间转换。

endTime

可选

String

query

查询产生时间在endTime之前的历史数据。需要填写UTC时间,格式:yyyyMMdd'T'HHmmss'Z',如 20151212T121212Z。

您需要根据本地所在时区自己进行时间转换。

support.huaweicloud.com/api-IoT/iot_06_0062.html