创建云网关设备(MQTT)

您需为一方认证的云网关产品导入设备认证信息来创建云网关设备,用于真实设备接入物联网平台时认证连接。本文介绍导入设备认证信息的具体步骤。

前提条件

已添加云网关并成功创建一方认证的云网关产品。具体操作,请参见创建云网关产品(MQTT)

使用限制

部分产品需批量导入设备认证信息进行设备创建,不支持单个创建设备:

背景信息

  • 三方认证的云网关创建成功后,设备首次建连时,物联网平台会根据三方认证服务的返回参数deviceName值自动创建对应的设备。

    您可使用MQTT.fx工具模拟云网关设备接入物联网平台进行通信。具体操作,请参见设备使用MQTT.fx接入(阿里云FC认证)

  • 一方认证的云网关创建成功后,需您在物联网平台导入设备认证信息来创建云网关设备。具体操作,请参见下文。

批量添加设备

  1. 登录物联网平台控制台

  2. 实例概览页面,单击目标尊享型实例。

  3. 在左侧导航栏选择设备管理 > 产品,找到已创建的云网关产品,单击右侧操作栏的管理设备

  4. 在设备页面,单击批量添加

    批量添加

  5. 批量添加设备对话框,单击下载.csv模板下载表格模板。

    批量添加设备

  6. 在模板中填写SN、MQTT Username和MQTT Password,然后保存文件。

    重要
    • MQTT Username和MQTT Password必填,SN可不填。

    • MQTT Username支持英文字母、数字、短划线(-)、下划线(_)、at(@)、英文句号(.)和英文冒号(:),长度限制为4~32个字符。MQTT Username在产品维度下不可重复。

    • MQTT Password 支持英文字母、数字、短划线(-)、下划线(_)、at(@)、英文句号(.)和英文冒号(:),长度限制为1~32个字符。

    • 一个文件中最多可包含1万条设备记录。请不要导入重复的设备。

    设备文件

  7. 回到批量添加设备对话框,单击上传文件,将填好的表格上传至物联网平台控制台,单击确认

    上传文件

    若批量上传的设备列表中有不合法的输入信息,将出现错误提示。请单击下载不合法列表,查看不合法的输入信息,并进行修正,再重新上传文件。

    不合法输入

相关API

API

描述

ImportDevice

在MQTT云网关产品下单个导入设备。

BatchImportDevice

在MQTT云网关产品下批量导入设备。

BatchCheckImportDevice

批量校验导入的设备。

QueryImportedDeviceByApplyId

根据申请批次ID(ApplyId)查询批量导入的设备列表。

执行结果

设备身份导入成功后,物联网平台以上传的MQTT Username值作为设备名称创建对应设备,设备列表显示已创建的设备信息。设备列表

后续步骤

创建云网关设备完成后,需更新设备的接入域名:

  • 若设备已配置接入域名,可配置CNAME解析到云网关连接域名(云网关URL)。域名解析详细操作,请参见云解析DNS

  • 若设备未配置接入域名,需将云网关URL配置到设备中。更多信息,请参见MQTT协议的设备接入

云网关URL获取方法,请参见查看云网关URL

云网关设备接入物联网平台实现通信的详细说明,请参见消息通信说明

您可使用MQTT.fx工具模拟云网关设备接入物联网平台进行通信。具体操作,请参见设备使用MQTT.fx接入(一方认证)