全部产品
Search
文档中心

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

更新时间:Jun 29, 2023

产品是设备的集合,通常指一组具有相同功能的设备。创建产品完成后,需在产品下添加设备,获取设备证书。您可在物联网平台上,同时创建一个或多个设备。本文介绍同时创建多个设备的操作。

前提条件

已完成创建产品。具体操作,请参见创建产品

操作步骤

  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:下载该批次设备的证书。

后续操作

查看设备信息,请参见查看设备信息

创建设备完成后,设备状态显示为未激活。您需开发设备端SDK,将设备接入物联网平台,使其激活,请参见下载设备端SDK设备未激活

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

相关API

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