全部產品
Search
文件中心

IoT Platform:大量建立裝置

更新時間:Jun 30, 2024

產品是裝置的集合,通常指一組具有相同功能的裝置。建立產品完成後,需在產品下添加裝置,擷取裝置認證。您可在物聯網平台上,同時建立一個或多個裝置。本文介紹同時建立多個裝置的操作。

前提條件

已完成建立產品。具體操作,請參見建立產品

操作步驟

  1. 登入物聯網平台控制台

  2. 執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。

  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:批次申請指定數量裝置。