# 檢視匯入任務和裝置加入狀態
<a name="sidewalk-bulk-provision-status"></a>

您的無線裝置匯入任務，而您已新增至該任務的 Sidewalk 裝置可能具有下列其中一種狀態訊息。您將會看到這些訊息顯示於 AWS IoT 主控台中，或是您使用任何 AWS IoT Wireless API 操作或 AWS CLI 命令擷取這些任務及其裝置相關資訊的時間。

## 檢視匯入任務狀態資訊
<a name="provisioning-status-view"></a>

當您建立匯入任務後，則可檢視您所建立的匯入任務，以及新增至任務之裝置的加入狀態。加入狀態會指出等待加入的裝置數量、已成功加入的裝置數量，及無法加入的裝置數量。

當匯入任務剛剛建立時，**待定計數**將會顯示一個與新增裝置數量相對應的值。一旦任務啟動並讀取 CSV 檔案以建立無線裝置記錄後，**待定計數**就會減少，而**成功計數**也會隨著裝置的成功加入而增加。若有任何裝置無法加入，**失敗計數**將會增加。

如要檢視匯入任務和裝置加入狀態：
+ 

**使用 AWS IoT 主控台**  
於 AWS IoT 主控台的 [Sidewalk 裝置中樞](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)中，您可查看您所建立的匯入任務，及裝置加入狀態資訊摘要的計數。若您檢視所建立之任何匯入任務的詳細資訊，則可檢視裝置加入狀態的其他相關資訊。
+ 

**使用 AWS IoT Wireless API 或 AWS CLI**  
如要檢視裝置加入狀態，請使用下列任一項 AWS IoT Wireless API 操作或對應的 AWS CLI 命令。
  + 

**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html) API 或 [https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html) CLI**  
此 API 操作會傳回有關已新增至您 AWS IoT Wireless 帳戶的所有匯入任務及其狀態的資訊。其還會傳回這些任務中 Sidewalk 裝置加入狀態摘要的計數。
  + 

**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) API 或 [https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html) CLI**  
此 API 操作會傳回有關指定匯入任務及其狀態的資訊，以及已新增至匯入任務之所有 Sidewalk 裝置及其加入狀態資訊的相關資訊。
  + 

**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) API 或 [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html) CLI**  
此 API 操作會傳回有關指定匯入任務及其狀態的資訊，以及該任務中 Sidewalk 裝置加入狀態摘要的計數。

## 匯入任務狀態
<a name="bulk-provisioning-status-task"></a>

您於AWS 帳戶 中所建立的匯入任務可能具有下列其中一種狀態訊息。該狀態會指出您的匯入任務是否已開始處理、或已完成或已失敗。您還可使用 AWS IoT 主控台或任何 AWS IoT Wireless API 操作的 `StatusReason` 參數，來擷取其他狀態詳細資訊。
+ 

**初始化**  
適用於 Amazon Sidewalk 的 AWS IoT Core 已收到無線裝置匯入任務請求，且正在設定任務。
+ 

**已初始化**  
適用於 Amazon Sidewalk 的 AWS IoT Core 已完成匯入任務的設定，並正等待控制日誌到達，以便使用裝置序號 (SMSN) 進行匯入並繼續處理任務。
+ 

**待定**  
匯入任務正在佇列中等待處理。適用於 Amazon Sidewalk 的 AWS IoT Core 正在評估處理佇列中的其他任務。
+ 

**完成**  
匯入任務已處理且完成。
+ 

**失敗**  
匯入任務或裝置任務失敗。您可使用 `StatusReason` 參數來識別匯入任務失敗的原因，例如驗證例外。
+ 

**正在刪除**  
匯入任務已標記為刪除，且正在刪除中。

## 裝置加入狀態
<a name="bulk-provisioning-status-devices"></a>

您新增至匯入任務的 Sidewalk 裝置可能具有下列其中一種狀態訊息。該狀態會指出您的裝置是否已準備好加入，或已加入或無法加入。您還可使用 AWS IoT 主控台或 AWS IoT Wireless API 操作 `ListDevicesForWirelessDeviceImportTask` 的 `OnboardingStatusReason` 參數 ，來擷取其他狀態的詳細資訊。
+ 

**已初始化**  
適用於 Amazon Sidewalk 的 AWS IoT Core 已完成匯入任務的設定，並正等待控制日誌到達，以便使用裝置序號 (SMSN) 進行匯入並繼續處理任務。
+ 

**待定**  
匯入任務正在佇列中等待處理，並開始將您的裝置加入該任務。適用於 Amazon Sidewalk 的 AWS IoT Core 正在評估處理佇列中的其他任務。
+ 

**已加入**  
已成功將 Sidewalk 裝置加入匯入任務。
+ 

**失敗**  
匯入任務或裝置任務失敗，且 Sidewalk 裝置無法加入任務。您可使用 `OnboardingStatusReason` 參數，擷取有關裝置加入失敗原因的其他詳細資料。