检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后(订阅的通知类型为swUpgradeStateChangeNotify),当设备进行软件升级,升级任务的状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
成功后: 调测“获取IAM用户Token”接口 在访问物联网平台业务接口前,应用服务器需要调用“获取IAM用户Token”接口鉴权,华为云认证通过后向应用服务器返回鉴权令牌X-Subject-Token。 应用服务器需要构造一个HTTP请求,请求示例如下: POST https://iam
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后(订阅的通知类型为deviceCapabilitiesChanged),在物联网平台上设备Profile文件中的服务和属性被修改时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
接口说明 应用服务器在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
使用前必读 非联通用户请查看设备接入服务。 MQTT概述 MQTT标准规范参见《mqtt-v3.1.1-os.pdf》。 MQTT的语法和接口细节,请以此标准为准。平台目前只支持MQTTS接入。 MQTT消息分为固定报头(Fixed header)、可变报头(Variable h
修改设备信息 接口说明 应用服务器在物联网平台注册设备后,若设备的基本信息发生变更,可调用此接口在物联网平台修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
接口说明 应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器下发命
Linux Demo使用的IDE工具为Visual Studio。开发者可以使用其他IDE工具。 使用必读 开发环境要求: 操作系统 工具链 当前支持的系统: ARM Linux (Embedded Linux) MIPS Linux (Embedded Linux) x86 Linux
接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息,包括对设备的配置信息(desired区)
查询物联网平台中指定订阅的配置信息。 修改订阅 修改物联网平台中的指定订阅配置,当前仅支持修改订阅回调地址(callbackurl)。 删除订阅 删除物联网平台中的指定订阅配置。 推送通知 应用服务器向物联网平台订阅信息,当订阅的信息发生变更时,物联网平台向应用服务器推送此消息,应用服务器根据通知
由于业务应用所在的网络不同,业务应用的访问地址也不同。 业务应用部署在公网时,业务应用的访问地址就是业务应用的公网IP:端口(或域名:端口)。 业务应用部署在局域网时,需要在业务应用配置网络穿透,生成业务应用的公网访问地址,具体配置自行从网上获取网络穿透工具的配置步骤。 不同通知类型的订阅,回调地址可以相同也可以不同,根据业务需求自定义。
信息。 取值范围:0~2147483647。若填写为“0”,则表示设备验证码不会失效(建议填写为“0”)。 默认值:180(默认值可配置,具体配置值请咨询物联网平台运维人员。) 单位:秒。 verifyCode 可选 String(256) body 设备验证码,若在请求中指定v
务属性的配置(服务属性为设备Profile文件中定义的service属性)。若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置,此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口在设备影子上配置要下发给设备的配置信息。
典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,在物联网平台查询指定设备影子的历史配置数据。 接口描述 1 QueryDeviceDesiredHistoryOutDTO
典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,在物联网平台查询指定设备影子的历史配置数据。 接口描述 1 def queryDevic
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发: