# 大量佈建 Sidewalk 裝置
本節將說明如何使用 AWS IoT 主控台和 AWS CLI，對適用於 Amazon Sidewalk 的 AWS IoT Core 大量佈建 Sidewalk 裝置。
## 大量佈建 Sidewalk 裝置 (主控台)
如要使用 AWS IoT 主控台新增您的 Sidewalk 裝置，請移至[裝置中樞的 Sidewalk 索引標籤](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)，選擇**大量佈建裝置**，然後執行下列步驟。
![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision.PNG)
1.
**選擇匯入方式**
指定您要將大量加入的裝置匯入適用於 Amazon Sidewalk 的 AWS IoT Core 的方式。
+ 如要使用其 SMSN 佈建個別裝置，請選擇**佈建個別的原廠支援裝置**。
+ 如要透過提供包含裝置及其 SMS 清單的 CSV 檔案，大量佈建裝置，請選擇**使用 S3 儲存貯體**。
1.
**指定要加入的裝置**
視您選擇將裝置加入的方法而定，新增裝置資訊及其序號。
1. 若您選擇**佈建個別的原廠支援裝置**，請指定下列資訊：
1. 每個要加入之裝置的**名稱**。該新名稱在您的 AWS 帳戶 和 AWS 區域 中必須是唯一的。
1. 其在**輸入 SMSN**欄位中的 Sidewalk 製造序號 (SMSN)。
1. 描述將訊息從裝置路由至其他 AWS 服務 之 IoT 規則的**目的地**。
1. 若您選擇**使用 S3 儲存貯體**：
1. 提供包含 S3 URL 資訊的 **S3 儲存貯體目的地**資訊。如要提供 CSV 檔案，請選擇**瀏覽 S3**，然後選擇您想要使用的 CSV 檔案。
適用於 Amazon Sidewalk 的 AWS IoT Core 會自動填入 S3 URL，其為前往 S3 儲存貯體中 CSV 檔案的路徑。路徑的格式為 `s3://bucket_name/file_name`。若要在 [Amazon Simple Storage Service](https://console.aws.amazon.com/s3/) 主控台中檢視檔案，請選擇 **View** (檢視)。
1. 提供 **S3 佈建角色**，此可讓適用於 Amazon Sidewalk 的 AWS IoT Core 代表您存取 S3 儲存貯體中的 CSV 檔案。您可以建立新的服務角色或選擇現有角色。
如要建立新角色，您可提供一個**角色名稱**，或者保留空白，以自動產生隨機名稱。
1. 提供一個描述將訊息從裝置路由至其他 AWS 服務 之 IoT 規則的**目的地**。
1. 啟動匯入任務
提供任何選用標籤作為名稱/值組，並選擇**提交**以開始無線裝置匯入任務。
## 大量佈建 Sidewalk 裝置 (CLI)
如要將 Sidewalk 裝置加入您的適用於 Amazon Sidewalk 的 AWS IoT Core 帳戶，請使用下列任何 API 操作，這將取決於您要個別新增裝置，還是提供包含於 S3 儲存貯體中的 CSV 檔案。
+
**使用 S3 CSV 檔案大量上傳裝置**
如要透過在 S3 儲存貯體中提供 CSV 檔案以大量上傳裝置，請使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html) AWS CLI 命令。建立任務時，請指定 Amazon S3 儲存貯體中 CSV 檔案的路徑，並指定 IAM 角色，以便將存取 CSV 檔案的許可授予適用於 Amazon Sidewalk 的 AWS IoT Core。
一旦任務開始執行後，適用於 Amazon Sidewalk 的 AWS IoT Core 將會開始讀取 CSV 檔案，並將檔案中的序號 (SMSN) 與從 Amazon Sidewalk 所收到之控制日誌中的對應資訊進行比較。若序號相符，其將會開始建立與這些序號對應的無線裝置記錄。
下列命令顯示建立匯入任務的範例：
```
aws iotwireless start-wireless-device-import-task \
--cli-input-json "file://task.json"
```
下列顯示 `task.json` 檔案的內容。
**task.json 的內容**
```
{
"DestinationName": "Sidewalk_Destination",
"Sidewalk": {
"DeviceCreationFile": "s3://import_task_bucket/import_file1",
"Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"
}
}
```
執行此命令會傳回匯入任務的 ID 和 ARN。
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
"Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
```
+
**使用其 SMSN 個別佈建裝置**
如要使用其 SMSN 個別佈建裝置，請使用 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html) API 操作或 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html) AWS CLI 命令。建立任務時，請指定 Sidewalk 目的地和您要加入的裝置序號。
當序號與從 Amazon Sidewalk 所收到之控制日誌中的對應資訊相符時，會執行任務並建立無線裝置記錄。
下列命令顯示建立匯入任務的範例：
```
aws iotwireless start-single-wireless-device-import-task \
--destination-name sidewalk_destination \
--sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'
```
執行此命令會傳回匯入任務的 ID 和 ARN。
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
"Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
}
```
## 更新或刪除匯入任務
若您想要將其他裝置新增至匯入任務，您可以更新該任務。若您不再需要某任務或其已失敗，則還可將其刪除。如需有關何時更新或刪除任務的資訊，請參閱 [Sidewalk 大量佈建的使用方式](sidewalk-provision-bulk-import.md#provision-bulk-use)。
**警告**
刪除動作為永久性動作，且無法還原。刪除已順利完成的匯入任務將不會移除已使用該任務加入的終端裝置。
如要更新或刪除匯入任務：
+
**使用 AWS IoT 主控台**
下列步驟說明如何使用 AWS IoT 主控台來更新或刪除匯入任務。
**如要更新匯入任務：**
1. 請移至 AWS IoT 主控台的 [Sidewalk 裝置中樞](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)。
1. 選擇您要更新的匯入任務，然後選擇**編輯**。
1. 提供另一個包含您要新增至任務之裝置序號的 S3 檔案，然後選擇**提交**。
**如要刪除匯入任務：**
1. 請移至 AWS IoT 主控台的 [Sidewalk 裝置中樞](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)。
1. 選擇您要刪除的任務，然後選擇**刪除**。
+
**使用 AWS IoT Wireless API 或 AWS CLI**
使用下列 AWS IoT Wireless API 操作或 CLI 命令來更新或刪除您的匯入任務。
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html) API 或 [https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html) CLI**
此 API 操作會將 Amazon S3 CSV 檔案的內容附加至現有的匯入任務。您僅可新增先前未包含於任務中的裝置序號。
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html) API 或 [https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html) CLI**
此 API 操作會使用匯入任務 ID 刪除標記為要刪除的匯入任務。