检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
自定义Topic通信 自定义Topic通信概述 $oc开头自定义Topic通信使用说明 非$oc开头自定义Topic通信使用说明 父主题： 消息通信
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。。
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
IoT平台设备侧支持MQTT协议的connect消息接口，鉴权通过后建立设备与平台间的MQTT连接。 参数说明 设备通过MQTT协议的connect消息进行鉴权，对于构造ClientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。 当
以NB-IoT场景为例，编解码插件将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”，将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备（UE）“理解执行”。NB-IoT设备和物联网平台之间采用CoAP协议通讯，CoAP消息的payload为应用层数据，应用层数据的格式由设备自行
若为空则默认该参数与Topic中的device_id一致。 services 可选 List<ServiceEvent> 参数解释： 事件服务列表。 ServiceEvent定义表 字段名 必选/可选 类型 参数描述 service_id 必选 String 参数解释： 系统字段。
所有设备”，单击具体设备，启动“消息跟踪”。 图3 消息跟踪-启动消息跟踪 设备端运行设备侧SDK代码，设备侧消息上报日志格式样例如下： 图4 java SDK消息上报结果log “消息跟踪”显示结果如下，平台已经收到设备的消息上报，并且已经触发流转规则: 图5 消息跟踪-消息上报触发流转规则 父主题：
置产品的服务。 图6 自定义模型-MQTT 新增服务类型“Location”。 在“新增服务”页面，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。 图7 添加服务-Location “服务ID”：Location “服务类型”：建议和服务ID保持一致 “服务描述”：设备上报的位置数据
全部 异步命令下发 消息下发 支持向设备下发MQTT消息，应用服务器可调用消息下发接口向指定设备下发消息，以实现对设备的控制。设备MQTT消息下发分为缓存下发和立即下发， 当设备在线时会立即下发， 当设备不在线时会先把消息缓存起来，等设备上线后下发。 图1 消息缓存下发流程图 支持区域：
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
即可发送。 图12 设备A Publish页面输入消息 在设备B的Subscribe页面可以看到接收的消息如下： 图13 设备B Subscribe页面展示 父主题： 设备间消息通信（M2M）
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。。
功能介绍 应用服务器在调用物联网平台创建规则触发条件（Resource:batchtask，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建批量任务状态变更通知规则的转发目标决定
下发广播消息 功能介绍 应用服务器可调用此接口向订阅了指定Topic的所有在线设备发布广播消息。应用将广播消息下发给平台后，平台会先返回应用响应结果，再将消息广播给设备。 注意： 此接口只适用于使用MQTT协议接入的设备。 调用方法 请参见如何调用API。 URI POST /v
查询设备消息 查询指定设备下的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 下发设备消息 向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。
故订阅Topic的QoS为1时平台会重发消息。平台重发消息后，设备会收到重复消息，建议设备要有去重机制。 相关API接口 下发设备消息 平台消息下发 消息缓存下发使用说明 消息下发是平台向设备直接下发消息的一种方式。消息下发具有缓存特性，当设备不在线时，平台会对下发的消息进行缓存，直到设备上线。
设备间消息通信（M2M） 设备间消息通信概述 设备间消息通信使用说明 设备间消息通信使用示例 父主题： 消息通信
msg_type 必选 String 属性上报的消息类型，固定为： properties_set_response request_id 可选 String 用于唯一标识这次请求，设备侧收到的消息带该参数时，响应消息需要将该参数值返回给平台。如果解码后的消息不带该字段，则以topic中带的request_id为准。
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
应用在接收处理物联网平台发送的响应消息和推送消息时，需要兼容或忽略消息中的新增参数，不能因为消息中的新增参数导致应用的处理异常。 调用API的其他使用限制，请参见物联网平台的使用限制。 基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
