检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询产品列表 功能介绍 应用服务器可调用此接口查询已导入物联网平台的产品模型信息列表，了解产品模型的概要信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products 表1 路径参数 参数 是否必选 参数类型 描述 project_id
订阅：是指应用服务器通过调用物联网平台的API接口，向平台获取发生变更的设备业务信息（如设备注册、设备数据上报、设备状态等）和管理信息（软固件升级状态和升级结果）。 推送：是指订阅成功后，物联网平台根据应用服务器订阅的数据类型，将对应的变更信息推送给指定的URL地址或AMQP消息队列。 token 鉴
应用服务器可调用此接口配置设备影子的预期属性（desired区），当设备上线或者设备上报属性时把属性下发给设备。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识 设备影子用于存储设备上报的(状态)属性和应用程序期望的设备(状态)属性
客户端程序，单击“设置”。 填写 Connection Profile 相关信息和 General 信息。其中General 信息可以用工具默认的参数配置。 填写 User Credentials 信息。 其中Username 和Password 参数参考MQTT CONNECT连接鉴权参数说明。
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
通过设备发放实现批量设备自动注册 场景说明 当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备数不断增多时，如何安全且快速的注册设备尤为关键，需要采用安全的批量注册的场景。本文基于设备发放注册组功能，使用证书策
连接配置说明 MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下： MQTT接入域名 每个账号会自动生成，请前往控制台-接入信息页面获取。 图1 接入信息-应用侧MQTT接入地址 端口：8883 客户端身份认证参数 clientId：全局唯一即可，建议使用“username”。 username
例卡片进入实例。 图1 实例管理-切换实例 查看实例 IoTDA实例购买成功后，您可以进入实例详情页面查看实例的详情信息，包括实例Id，实例名称，实例规格配置等信息。 访问设备接入服务，单击“管理控制台”进入设备接入控制台。 选择左侧导航栏“IoTDA实例”，单击实例对应的“详情”进入实例详情页面。
情页面。 图2 设备-设备详情 页签名 说明 设备信息 查看设备信息：查看设备基本信息，包括设备标识码（nodeId）、设备ID（deviceId），节点类型、设备软固件版本信息等。用户也可通过调用修改设备接口修改设备的基本信息。 设备标识码（nodeId），设备唯一物理标识，如
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。
使用场景 全球设备，单点发放 无需人工干预，在设备出厂时对设备的接入信息进行硬编码，设备统一烧录全球统一的设备发放接入信息，通过全球统一的设备发放服务实现跨区域的自动发放能力。 多用户隔离 设备出厂前统一在设备发放管理和接入，根据配置实现出厂后接入到不同用户的IoT平台。 动态完成不同批次设备初始化配置
字段名 必选/可选 类型 参数描述 devices 必选 List<DeviceInfo> 参数解释： 设备信息列表。 version 必选 Long 参数解释： 子设备信息版本。 DeviceInfo定义表 字段名 必选/可选 类型 参数描述 parent_device_id 必选
通过平台接口实现南向“数据上报”、“命令下发”的功能，通过应用侧的示例代码接收北向服务端订阅的消息示例。以智慧路灯为例，设备将光照强度等信息上报到IoT平台，应用服务器再接收从平台推送来的设备数据。 视频指导 Your browser does not support video
设备上线时，需要从原始设备消息中解析出鉴权信息（设备ID和密钥），再调用SDK提供的login接口向平台发起登录请求，平台收到设备的login请求后，会对设备的鉴权信息进行认证，认证通过后会通过返回码告知网桥SDK设备的登录结果。您需要根据登录结果对设备进行记录会话信息、给设备返回响应等处理。 设备数据上报
平台查询设备属性 功能介绍 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后，需要将设备的属性数据返回给平台，如果设备没回响应平台会认为属性查询请求执行超时。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与
devices 必选 List<DeviceInfo> 参数解释： 设备列表。 version 必选 Long 参数解释： 子设备信息版本。网关设备可以保存此信息用于同步子设备列表时携带此参数。 DeviceInfo定义表 字段名 必选/可选 类型 参数描述 parent_device_id
时掌握所有接入IoTDA的设备信息。 设备消息跟踪：在设备鉴权，命令下发，数据上报，平台数据转发等业务场景发生故障时，可以通过消息跟踪进行快速定位和原因分析。 查看报表：IoTDA为用户提供了丰富的报表功能，用户可以通过不同维度查看各类报表统计信息，包括设备消息，设备状态，设备总数等。
Precondition Failed 物联网平台向设备订阅资源，设备获取到物联网平台下发订阅时的token，调用属性上报等其他接口时，都需要携带token信息。 Operation CoAP Method URI Success Failure Observe GET with Observe option
通信方式概述 设备接入物联网平台，通过物联网平台进行通信。设备、服务器和物联网平台的通信流程示意图如下。 设备发送数据到物联网平台 设备接入物联网平台后，便可与物联网平台进行通信。设备可通过以下方式发送数据到物联网平台： 设备消息上报：设备无法按照产品模型中定义的属性格式进行数据
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
