检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
ders。 单击“Send”，在下方查看返回码和响应消息内容。 调测“创建设备”接口 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台创建设备。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 应用服务器需要构造一个HTTP请求，请求示例如下： POST https://iotda
息完成接入鉴权。 设备名称 设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。 例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。 设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。
下发设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如
概述 设备接入流程图 图1 设备接入流程图 设备接入协议 华为云物联网平台支持多种接入方式和接入协议，满足各类设备和接入场景要求。请根据设备类型，选择合适方式接入到平台。 表1 协议清单 类型 子类型 协议编码 版本 适用场景 指导链接 通用协议 直连云端 MQTT/MQTTS 5
n字节的十六进制数 STRING 字符串 查询设备版本号 从设备的软件升级流程（本流程只描述物联网平台与设备基于PCP协议交互的流程）可以看到，首先物联网平台向设备下发查询版本号信息，设备进行应答。 物联网平台发送消息 根据PCP消息结构的定义可以得出，物联网平台向设备下发查询版本号时，各消息字段的填写如下：
注册设备 注册单个设备 批量注册设备 注册X.509证书认证的设备 设备自注册 父主题： 设备管理
平台下发时，若为直连设备，不携带该参数。 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。 service_id 可选 String 参数解释： 设备的服务ID，在设备关联的产品模型中定义。 command_name 可选 String 参数解释： 设备命令名称，在设备关联的产品模型中定义。
String 参数解释： 日志类型。 取值范围： DEVICE_STATUS ：设备状态。 DEVICE_PROPERTY ：设备属性。 DEVICE_MESSAGE ：设备消息。 DEVICE_COMMAND：设备命令。 content 必选 String 参数解释： 日志内容。 示例
可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。 业务流程 修改设备属性值 修改desired区属性值，如果设备在线，则设备影子直接同步设备属性值到设备，否则等待设备上线或上报数据时，再同步设备属性值到设备。 用户通
限制最大为1/S(每秒1次请求数)。 使用场景 设备检索：在所有设备-设备列表界面通过类SQL语句方式，检索指定的设备进行后续管理操作。 设备动态分组：通过设备动态分组的类SQL语句规则，过滤出来符合条件的设备自动加入到群组进行管理。 操作步骤 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
在设备接入控制台左侧导航栏，选择“设备 > 所有设备”，进入设备列表页，设备列表默认显示当前实例下的所有设备。 单击需要进行操作的设备“详情”按钮，单击“重置密钥/重置指纹”，单击“辅密钥/辅指纹”。 图1 设备详情-重置辅密钥 图2 设备详情-重置辅指纹 相关API接口 重置设备指纹 重置设备密钥 父主题：
台注册设备，获取设备ID和密钥，并把设备ID和密钥烧录到设备中。对于使用MQTTS协议接入的设备，需要在设备侧预置CA证书；对于使用MQTT非安全协议接入的设备，无需在设备侧预置CA证书。在设备接入物联网平台时携带设备ID和密钥，完成设备的接入鉴权。 使用证书鉴权： 在设备接入物
设备发放策略 自定义策略 证书策略 静态策略 父主题： 设备发放
String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
冻结设备 功能介绍 应用服务器可调用此接口冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备，如需批量冻结设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
设备命令 平台命令下发 父主题： 设备侧MQTT/MQTTS接口参考
description String 设备组描述。 super_group_id String 父设备组ID，该设备组的父设备组ID。 group_type String 参数说明：设备组类型，默认为静态设备组；当设备组类型为动态设备组时，需要填写动态设备组规则 请求示例 POST ht
将产品模型直接导入“物联网平台”。 通过本地导入的产品模型不含编解码插件，如果设备上报采用的是二进制码流，请前往控制台进行插件开发或导入插件。 上传模型文件 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 单击左侧导航栏的“产品”，在产品
删除设备隧道 功能介绍 用户可通过该接口删除某个设备隧道。删除后该通道不存在，无法再次连接。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/tunnels/{tunnel_id}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
