检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备影子 接口说明 若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
Header 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理
鉴权 接口说明 应用服务器首次访问物联网平台的开放API时，需调用此接口完成认证鉴权，获取accessToken。 注意事项 鉴权接口是调用其他API的前提，除了调用鉴权接口，其他接口调用都需要在request header中携带参数app_key和Authorization。a
数据转发至OBS长期储存（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 对于设备上报的数据，即使创建应用时开启了存储数据能力，设备管理服务也只保存7天的历史数据。 若您希望长期保存数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将
URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址，为“host:port”格式，host为服务器的访问域名或IP，port为服务器的访问端口，您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理
接口说明 应用服务器通过物联网平台创建设备命令时，如果设置了callbackurl回调地址，当命令状态变化时（执行失败，执行成功，超时，发送，已送达），平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器下发命
），并且该字段在两种消息的字段列表中的位置必须相同，使编解码插件可以对数据上报消息和命令响应消息进行区分。 需要在命令下发消息和命令响应消息中定义响应标识字段（mid），并且该字段在两种消息的字段列表中的位置必须相同，使编解码插件可以将命令下发消息和对应的命令响应消息进行关联。
e做分页查询。 pageSize 可选 Integer query 分页查询参数，查询结果分页显示时每页显示的记录数，默认1，最大值2000，建议根据设备上报数据的平均大小来设置，保证单次查询返回的包大小不超过16Mb，同时根据单次查询返回的包大小以及网络带宽设置合理的超时时间。
什么是Profile（联通用户专用） 非联通用户请查看设备接入服务。 Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
查询单个设备信息 接口说明 已在物联网平台注册的设备，应用服务器若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}
业务数据的跟踪。 接入 可查询绑定在该应用下的设备与物联网平台进行数据对接的不同协议所对应的端口信息。 可查询绑定在该应用上的应用服务器与物联网平台进行数据对接的端口信息。 应用和设备接入的域名和接口信息，请在设备接入服务的控制台上获取。 消息推送 推送协议是由应用服务器在订阅物
钟），然后通过轮询的方式向各个推送失败的应用服务器进行推送重试，缓存时间超时后如果还未推送成功，物联网平台不再进行推送重试。在消息缓存时间内，物联网平台重试推送失败的次数达到10次后，会将该推送的URL地址设置为无效，并按照轮询的方式，轮询探测所有失败URL的有效性，如果恢复，则
Header 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理
query 分页查询参数，查询结果分页显示时指定要查看的页信息，默认0，查询第一页，取值范围为大于等于0的整数。 “gatewayId”与“pageNo”不能同时为空。 pageSize 可选 Integer query 分页查询参数，查询结果分页显示时每页显示的记录数，默认值为25，取值范围为1-250的整数。
Lite SDK的设备：设备通过注册时填写的“设备标识码”和“预置密钥”接入平台。 无真实设备时可随意填写英文字母和数字的组合字符串。 预置密钥 NB-IoT设备、集成Agent Lite SDK的设备接入时，用于设备和物联网平台之间的传输通道安全加密。 原生MQTT设备接入时，暂无作用，可随意填写。
查询指定任务信息 接口说明 在创建了设备软件升级任务或固件升级任务后，应用服务器可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations/{operationId}
物联网平台如何切换设备的在线/离线状态？ NB-IoT设备上报数据后为状态为在线，距离上次上报数据25小时内未上报数据，会刷新状态为离线。 MQTT设备连接到平台后状态为在线，断开连接后平台1分钟内会自动刷新状态为离线。如果手动点击状态刷新按钮，则可实时刷新为离线状态。 更多请参考设备监控。
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
