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

前提条件

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

背景信息

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

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

批量添加设备

  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

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