阿里云物联网平台：批量创建设备

操作步骤

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

2. 在实例概览页签的全部环境下，找到对应的实例，单击实例ID或备注名称。

   重要

   目前仅开通企业版实例服务的地域下，执行此步骤。其他地域，请跳过此步骤，执行下一步。地域及实例的支持说明，请参见实例概述。

3. 在左侧导航栏，选择设备管理 > 设备。

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

5. 选择产品。新创建的设备会继承该产品的功能和特性。

   重要

   若该产品关联了其他平台，请确保您的阿里云账号下有足够的激活码用于创建设备。

   

6. 选择设备的添加方式。

   • 自动生成：无需为设备指定DeviceName。填写设备数量后，系统会为每个设备自动生成由字母、数字随机组合成的DeviceName。

   • 批量上传：需要为所有设备指定名称。单击下载.csv模板下载表格模板，在模板中填写DeviceName、Nickname，然后将填好的表格上传至物联网平台控制台。

     重要

     • 第一行不能修改，请从A2单元格开始输入。

     • DeviceName支持英文字母、数字、短划线（-）、下划线（_）、at（@）、英文句号（.）和英文冒号（:），长度限制为4~32个字符。DeviceName在产品维度下具有唯一性，不可重复。

     • Nickname为备注名称，可不填，支持中文、英文字母、日文、数字和下划线（_），长度限制为4~64个字符，一个中文或日文占2个字符。

     • 一个文件中最多可包含1万条记录，文件大小不超过2 MB。

7. 单击确认，完成批量创建设备。

   若批量上传的设备名称列表中有不合法的名称，会出现错误提示。请单击下载不合法列表，查看不合法的设备名称，并根据设备名称规范，修改设备名称，再重新上传文件。

8. 创建设备成功后，单击下载设备证书，下载本批次设备的设备证书，用于在产线上统一烧录。

   设备证书由设备的ProductKey、DeviceName和DeviceSecret组成，是设备与物联网平台进行通信的重要身份认证，建议您妥善保管。

   参数	说明
   ProductKey	设备所属产品的ProductKey，即物联网平台为产品颁发的全局唯一标识符。
   DeviceName	设备在产品内的唯一标识符。DeviceName与设备所属产品的ProductKey组合，作为设备标识，用来与物联网平台进行连接认证和通信。
   DeviceSecret	物联网平台为设备颁发的设备密钥，用于认证加密。需与DeviceName成对使用。

执行结果

创建设备成功后，可在设备页面的批次管理页签下，单击对应产品的：

• 详情：查看该批次设备的添加数量和设备列表（包含设备证书和状态等信息）。

  若该批次设备中包含创建失败的设备，设备列表中会显示失败原因，对应的错误码说明如下。

  错误码	含义	说明
  460	duplicated deviceName	设备名称重复。
  	invalid deviceName	设备名称无效。
  6251	device exist	设备已存在。
  6760	insufficient activation code	激活码不足。
  64003	device creation is failed	并发执行创建设备操作。
  6293	device has been distributed	设备已分发。

• 下载量产成功CSV：下载该批次设备的证书。

后续操作

查看设备信息，请参见查看设备信息。

设备接入物联网平台实践案例，请参见：

• 使用MQTT.fx接入物联网平台

• Android Things接入物联网平台

相关API

BatchRegisterDevice：批次申请指定数量设备。