检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
gateway_id 否 String 参数说明：网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 最大长度：256 device_name
gateway_id 否 String 参数说明：网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 最大长度：256 device_name
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或
测试验证步骤如下： 在设备接入控制台，进入“设备 > 所有设备”，单击具体设备，启动“消息跟踪”。 图3 消息跟踪-启动消息跟踪 设备端运行设备侧SDK代码，设备侧消息上报日志格式样例如下： 图4 java SDK消息上报结果log “消息跟踪”显示结果如下，平台已经收到设备的消息上报，并且已经触发流转规则:
“关键字”为注册组名称中的关键字。设备发放时，注册组下的设备的设备名称为“注册组名称+设备ID”，如果包含设置的关键字，则可按该实例进行发放。 图5 创建静态策略 新增注册组 图6 新增注册组 图7 创建证书静态注册组 设备引导 下载并修改华为SDK示例代码进行设备引导（这里以java sdk代码为示例）。
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
产品的服务。 新增服务类型“Connectivity”。 在“添加服务”页面，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。 “服务ID”：Connectivity “服务类型”：建议和服务ID保持一致 “服务描述”：Connectivity 图4 添加服务-Connectivity
携带的设备证书指纹。 使用设备证书接入平台。 图1 设备连接参数 进入设备接入控制台，左侧导航栏选择“设备 > 设备证书”，选择“设备证书”查看设备证书列表与详情。 图2 设备证书-证书列表 图3 设备证书-证书详情 进入设备接入控制台，左侧导航栏选择“设备 > 所有设备”，选择
上传设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台上传设备CA证书 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
创建。详情可见：创建产品。 创建设备。在设备接入控制台，单击左侧导航栏“设备 > 所有设备”，单击“注册设备”。根据页面提示填写参数，然后单击“确定”，完成设备的创建。详情可见：注册单个设备。 生成策略 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
设备消息 设备消息上报 平台消息下发 父主题： 设备侧MQTT/MQTTS接口参考
设备鉴权 接口说明 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如
}); 访问设备接入服务，单击“控制台”进入设备接入控制台。选择左侧导航栏“IoTDA实例”，单击您需要的实例卡片进入实例。在左侧导航栏选择“设备>所有设备”，单击“详情”，在设备详情的消息跟踪页面可以查看平台是否收到对应消息。 图3 消息跟踪-查看消息跟踪 应用侧SDK接收消息 设备
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
设备联动 设备触发告警并邮件或短信通知 温度过高时自动关闭设备 煤气浓度过高自动打开推窗器 监测设备状态变化情况并发送通知
sleep(10) 设备上报属性成功后可在设备详情页面查看到上报的属性。 图1 查看上报数据-Battery_batteryLevel 如果在“设备详情”页面没有最新上报数据，请确认设备上报的服务/属性和产品模型中的服务/属性一致。 消息上报 消息上报是指设备向平台上报消息。message_sample
设备请求引导消息 接口功能 设备向发放服务请求对应设备接入实例的引导信息。 Topic 表1 上报Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/up 消息发送方 设备 消息接收方 设备发放平台 示例 设备向发放服务发送的payload为空。
开通服务 本章节介绍如何在“华北-北京四”区域开通一个标准版免费实例单元，以进行IoTDA平台快速入门的体验。 访问设备接入服务，单击“控制台”进入设备接入控制台。 在左侧导航栏，选择“IoTDA实例”，单击“开通免费单元”。 图1 实例-标准版-开通免费实例 按下图选择配置信息，均采用默认配置即可。
设备消息上报 设备消息上报 父主题： 设备侧HTTPS接口参考
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
