检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
一机一密的设备ClientId由4个部分组成：设备ID、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。 设备ID：指设备在平台成功注册后生成的唯一设备标识，通常由设备的产品ID和设备的NodeId通过分隔符“_”拼装而来。 设备身份标识类型：固定值为0，表示设备ID。 密码签名类型：长度1字节，当前支持2种类型：
MQTT CONNECT连接鉴权 接口功能 设备发放平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 设备发放平台目前只支持MQTTS接入，设备通过connect消息接口和平台建立MQTT连接时，需要使用服务端
建立安全隧道的WebSocket连接 应用端 设备端 父主题： 安全隧道WebSocket接口参考
所有设备。 图1 设备-设备列表 表1 设备列表功能 功能 描述 搜索设备 根据状态、设备名称、设备标识码、设备ID、所属资源空间、所属产品和节点类型搜索具体设备。 查看设备信息 可查看设备状态、设备名称、设备标识码等，也可以单击设备对应的“详情”，查看设备详情。 删除设备 单击设备对应的“删除”。
创建设备隧道 功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地
发命令给设备。 图1 设备 + IoT平台 + 应用 设备 + IoT平台 + 华为云其他云服务 该场景为数据流转场景，设备将数据上报到IoT平台后，IoT平台对设备进行管理，通过自定义数据转发规则，将设备数据转发到华为云其他云服务，进行跨服务的业务处理。 图2 设备 + IoT平台
设备的产品模型中定义了平台可向设备设置的属性，平台/应用服务器可通过属性设置的方式修改指定设备的属性值。 平台查询设备属性 平台/应用服务器通过属性查询的方式，实时查询指定设备的属性数据。 平台命令下发 平台/应用服务器按产品模型中定义的命令格式下发控制命令给设备。 平台事件下发 平台/应用服务器按产品模型中定义的事件格式下发事件给设备。
参数说明: 设备接入隧道Token。创建设备隧道时，平台通过mqtt topic下发。 取值范围: 长度1-256。 tunnel_id 是 String Path 参数说明: 隧道ID，用于唯一标识一个隧道。 取值范围: 长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET
自定义设备侧域名 概述 自定义域名允许设备指定要连接到 IoTDA 的自定义完全限定域名 (FQDN)。使用自定义域名，用户可以管理自己的服务器证书，例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。
图2 设备-注册设备成功 若密钥丢失，可以按照设备认证凭证管理中的步骤更新设备密钥，无法找回注册设备时生成的密钥。 用户可在设备列表删除不再使用的设备。删除设备不支持撤回，请谨慎操作。 相关API参考 查询设备列表 创建设备 查询设备 修改设备 删除设备 重置设备密钥 父主题： 注册设备
关闭设备隧道 功能介绍 应用服务器可通过该接口关闭某个设备隧道。关闭后可以再次连接。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/tunnels/{tunnel_id}
解冻设备 功能介绍 应用服务器可调用此接口解冻设备，解除冻结后，设备可以连接上线。该接口仅支持解冻单个设备，如需批量解冻设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/unfreeze
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
冻结设备 功能介绍 应用服务器可调用此接口冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备，如需批量冻结设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
创建产品，创建MQTT协议产品（如果有MQTT协议产品可直接使用）。 注册单个设备。 设备群组，将注册的设备加入一个设备群组(创建升级任务时会用到)。 上传升级包 访问设备接入服务，单击“立即使用”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“设备 > 软固件升级”。 选择"资源包管理"页签，选择"固件列表"。
默认值：300 +HMCON OK（连接成功） serverip：设备接入服务器地址或者BS服务器地址。 默认值：BS服务器地址 +HMCON ERR：code（连接失败，code表示失败原因码） serverport：设备接入服务器端口或者BS服务器端口。 默认值：MQTTS端口8883
参数说明: 设备接入隧道Token。创建设备隧道时，平台通过mqtt topic下发。 取值范围: 长度1-256。 tunnel_id 是 String Path 参数说明: 隧道ID，用于唯一标识一个隧道。 取值范围: 长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。
下发异步设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发异步命令，以实现对设备的控制。平台负责将命令发送给设备，并将设备执行命令结果异步通知应用服务器。 命令执行结果支持灵活的数据流转，应用服务器通过调用物联网平台的创建
String 参数说明：连接MYSQL数据库的库名。 取值范围：长度不超过64，只允许字母、数字、下划线（_）、连接符（-）的组合。 username 是 String 参数说明：连接MYSQL数据库的用户名 password 是 String 参数说明：连接MYSQL数据库的密码
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
