

# インポートタスクを使用した Sidewalk デバイスのプロビジョニング
<a name="sidewalk-provision-bulk-import"></a>

このセクションでは、AWS IoT コンソール、AWS IoT Core for Amazon Sidewalk の API オペレーション、または AWS CLI を使用して Sidewalk デバイスを一括プロビジョニングする方法について説明します。以下のセクションでは、Sidewalk デバイスを一括プロビジョニングする方法について説明します。

**Topics**
+ [

## Sidewalk の一括プロビジョニングの仕組み
](#provision-bulk-works)
+ [

## Sidewalk 一括プロビジョニングに関する主な考慮事項
](#provision-bulk-considerations)
+ [

## CSV ファイル形式
](#provision-csv-format)
+ [

## Sidewalk 一括プロビジョニングの使用方法
](#provision-bulk-use)
+ [

# Sidewalk デバイスの一括プロビジョニング
](sidewalk-bulk-provision-how.md)
+ [

# インポートタスクとデバイスオンボーディングステータスの表示
](sidewalk-bulk-provision-status.md)

## Sidewalk の一括プロビジョニングの仕組み
<a name="provision-bulk-works"></a>

次の手順は、一括プロビジョニングの仕組みを示しています。

1. 

**ワイヤレスデバイスのインポートタスクを開始する**

   Sidewalk デバイスを一括でプロビジョニングするには、インポートタスクを作成し、AWS IoT Core for Amazon Sidewalk にオンボードするデバイスの Sidewalk 製造シリアル番号 (SMSN) を入力する必要があります。製造元が制御ログを Amazon Sidewalk にアップロードした後、デバイスの Sidewalk 製造シリアル番号 (SMSN) を CSV ファイルとして E メールで取得しました。ワークフローと制御ログの取得方法の詳細については、「Amazon Sidewalk ドキュメント」の「[Amazon Sidewalk デバイスの製造](https://docs.sidewalk.amazon/manufacturing/)」を参照してください。

1. 

**インポートプロセスをバックグラウンドで実行する**

   AWS IoT Core for Amazon Sidewalk はインポートタスクのリクエストを受け取ると、セットアップを開始し、システムを頻繁にポーリングするバックグラウンドプロセスを開始します。バックグラウンドプロセスがインポートタスクの指示を受け取ると、CSV ファイルの読み取りを開始します。AWS IoT Core for Amazon Sidewalk は同時に、制御ログが Amazon Sidewalk から受信されたかどうかをチェックします。

1. 

**ワイヤレスデバイスレコードを作成する**

   Amazon Sidewalk から制御ログを受け取ったら、AWS IoT Core for Amazon Sidewalk は制御ログのシリアル番号が CSV ファイルの SMSN 値と一致するかどうかをチェックします。シリアル番号が一致すると、AWS IoT Core for Amazon Sidewalk はこれらのシリアル番号に対応する Sidewalk デバイスのワイヤレスデバイスレコードの作成を開始します。すべてのデバイスのオンボードが完了すると、インポートタスクは完了とマークされます。

## Sidewalk 一括プロビジョニングに関する主な考慮事項
<a name="provision-bulk-considerations"></a>

Sidewalk デバイスを AWS IoT Core for Amazon Sidewalk に一括プロビジョニングする場合、次の主な考慮事項があります。
+ デバイスプロファイルを作成したときと同じ AWS アカウント で、AWS IoT コンソールまたは AWS IoT Core for Amazon Sidewalk の API オペレーションを使用して、一括プロビジョニングを実行する必要があります。
+ Sidewalk デバイスを一括プロビジョニングする前に、デバイスプロファイルにファクトリーサポートを示す DAK 情報が含まれている必要があります。そうしないと、AWS IoT コンソールを使用した一括プロビジョニングや、一括プロビジョニング API オペレーションが失敗する可能性があります。
+ インポートタスクを開始した後、CSV ファイルの処理、ワイヤレスデバイスのインポート、およびワイヤレスデバイスの AWS IoT Core for Amazon Sidewalk へのオンボードに少なくとも 10 分以上かかる場合があります。
+ ワイヤレスデバイスのインポートタスクは、開始後 90 日間実行されます。この間、Amazon Sidewalk から制御ログを受信したかどうかを確認します。90 日以内に Amazon Sidewalk から制御ログが届かない場合、タスクの詳細を表示すると、そのタスクは「完了」としてマークされ、有効期限が切れたことを示すメッセージが表示されます。インポートタスクで制御ログを待機していたデバイスのオンボーディングステータスが「失敗」としてマークされます。
+ 既に作成したインポートタスクを更新しようとすると、そのタスクには、他のデバイスのみを追加できます。インポートタスクを作成した後、インポートタスクに既に追加されているデバイスでタスクが開始される前であれば、いつでも新しいデバイスを追加できます。更新ファイルに、元のインポートタスクに既に存在するデバイスのシリアル番号が含まれている場合、これらのシリアル番号は無視されます。
+ 更新オペレーションをリクエストすると、インポートタスクの作成時に使用したものと同じ IAM ロールが Amazon S3 バケットの CSV ファイルにアクセスするとみなされます。
+ インポートタスクは、タスクが既に正常に完了しているか、タスクが更新に失敗した場合にのみ削除できます。正しくない IAM ロールが提供された場合や、Amazon S3 バケットファイルが見つからない場合など、タスクの更新に失敗することがあります。インポートタスクが `PENDING` 状態の場合、更新も削除もできません。
+ タスクにインポートする CSV ファイルは、次のセクションで説明する形式を使用する必要があります。

## CSV ファイル形式
<a name="provision-csv-format"></a>

インポートタスクに指定する Amazon S3 バケットに含まれる CSV ファイルは、次の形式を使用する必要があります。
+ 1 行目は `smsn` というキーワードを使用する必要があり、これはインポートする CSV ファイルにインポートするデバイスの SMSN が含まれていることを示しています。
+ 2 行目以降には、オンボードするデバイスの SMSN が含まれている必要があります。デバイスの SMSN は 64 進数文字形式である必要があります。

この JSON ファイルは、サンプル CSV ファイル形式を示します。

```
smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0
```

## Sidewalk 一括プロビジョニングの使用方法
<a name="provision-bulk-use"></a>

以下のステップで、Amazon Sidewalk 一括プロビジョニングの使用方法を示します。

1. 

**デバイスのシリアル番号を入力する**

   Sidewalk デバイスをプロビジョニングするには、オンボードするデバイスのシリアル番号を入力する必要があります。デバイスをプロビジョニングするには、次のいずれかの方法を使用します。
   + Sidewalk の製造シリアル番号 (SMSN) を使用して、各デバイスを個別にプロビジョニングします。この方法は、適切な IAM ロールを持つ CSV ファイルをアップロードしたり、デバイスがタスクにオンボードされる準備が整うのを待ったりせずに、ワークフローをテストしてデバイスをより速くオンボードしたい場合に役立ちます。
   + プロビジョニングするデバイスの SMSN を含む Amazon S3 バケット URL を CSV ファイルで指定して、デバイスを一括でプロビジョニングします。この方法は、オンボードするデバイスが多数ある場合に特に役立ちます。この場合、各デバイスを個別にオンボードするのは手間がかかる場合があります。代わりに、Amazon S3 バケットにアップロードされた CSV ファイルへのパスと、ファイルにアクセスするための IAM ロールを指定するだけで済みます。

1. 

**インポートタスクとデバイスオンボーディングステータスを取得する**

   作成したインポートタスクごとに、タスクのオンボーディングステータスと、タスクに追加されたデバイスのオンボーディングステータスに関する情報を取得できます。タスクやデバイスのオンボーディングが失敗した理由など、その他のステータス情報も確認できます。詳細については、以下を参照してください。

1. 

**(オプション) インポートタスクを更新または削除する**

   既に作成したインポートタスクを更新または削除できます。
   + 既に追加されているデバイスでタスクが開始される前であれば、いつでもインポートタスクを更新したり、タスクにデバイスを追加したりできます。AWS IoT Core for Amazon Sidewalk は、インポートタスクの作成時に使用したものと同じ IAM ロールを引き受けます。タスクを作成するときは、タスクに追加するデバイスのシリアル番号を含む新しい CSV ファイルを指定します。
**注記**  
既存のインポートタスクを更新する場合、タスクにデバイスを追加することのみ可能です。AWS IoT Core for Amazon Sidewalk は、インポートタスクに既にあるデバイスと、タスクに追加しようとしているデバイスとの間で、統合オペレーションを実行します。新しいファイルにインポートタスクに既に存在するデバイスのシリアル番号が含まれている場合、これらのシリアル番号は無視されます。
   + 既に正常に完了したインポートタスク、または IAM ロール情報が正しくない場合や、タスクの作成または更新時に S3 バケットファイルを使用できない場合などに更新に失敗したインポートタスクを削除できます。

**Topics**
+ [

## Sidewalk の一括プロビジョニングの仕組み
](#provision-bulk-works)
+ [

## Sidewalk 一括プロビジョニングに関する主な考慮事項
](#provision-bulk-considerations)
+ [

## CSV ファイル形式
](#provision-csv-format)
+ [

## Sidewalk 一括プロビジョニングの使用方法
](#provision-bulk-use)
+ [

# Sidewalk デバイスの一括プロビジョニング
](sidewalk-bulk-provision-how.md)
+ [

# インポートタスクとデバイスオンボーディングステータスの表示
](sidewalk-bulk-provision-status.md)

# Sidewalk デバイスの一括プロビジョニング
<a name="sidewalk-bulk-provision-how"></a>

このセクションでは、AWS IoT コンソールと AWS CLI を使用して Sidewalk デバイスを AWS IoT Core for Amazon Sidewalk に一括でプロビジョニングする方法について説明します。

## Sidewalk デバイスの一括プロビジョニング (コンソール)
<a name="provision-bulk-console"></a>

AWS IoT コンソールを使用して Sidewalk デバイスを追加するには、[デバイスハブの Sidewalk タブ](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)に移動し、**[デバイスの一括プロビジョニング]** を選択して、次の手順を実行します。

![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision.PNG)


1. 

**インポート方法を選択する**

   AWS IoT Core for Amazon Sidewalk にオンボードするデバイスを一括でインポートする方法を指定します。
   + 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 ファイルを選択します。

         AWS IoT Core for Amazon Sidewalk は、S3 バケット内にある CSV ファイルへのパスである S3 URL を自動的に入力します。パスの形式は `s3://bucket_name/file_name` です。[Amazon Simple Storage Service](https://console.aws.amazon.com/s3/) コンソールでファイルを表示するには、**[View]** (表示) を選択します。

      1. AWS IoT Core for Amazon Sidewalk がユーザーに代わって S3 バケット内の CSV ファイルにアクセスできるようにする、**[S3 プロビジョニングロール]** を提供します。新しいサービスロールを作成するか、既存のサービスロールを選択することができます。

         新しいロールを作成するには、**[ロール名]** を指定するか、空白のままにするとランダムな名前が自動的に生成されます。

      1. デバイスから他の AWS のサービス にメッセージをルーティングするための IoT ルールを説明した **[送信先]** を指定します。

1. インポートタスクを開始する

   任意のタグを名前と値のペアとして指定し、**[送信]** を選択してワイヤレスデバイスのインポートタスクを開始します。

## Sidewalk デバイスの一括プロビジョニング (CLI)
<a name="provision-bulk-api"></a>

Sidewalk デバイスを AWS IoT Core for Amazon Sidewalk のアカウントにオンボードするには、デバイスを個別に追加するか、S3 バケットに含まれる CSV ファイルを指定するかに応じて、次の API オペレーションのいずれかを使用します。
+ 

**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 ファイルへのパスと、AWS IoT Core for Amazon Sidewalk に CSV ファイルにアクセスするアクセス許可を付与する IAM ロールを指定します。

  タスクの実行が開始されると、AWS IoT Core for Amazon Sidewalk は 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"
  }
  ```

## インポートタスクの更新または削除
<a name="provision-bulk-modify"></a>

インポートタスクに他のデバイスを追加する場合は、タスクを更新できます。タスクが不要になった場合や失敗した場合は、タスクを削除することもできます。タスクを更新または削除するタイミングについては、「[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 を使用して削除対象としてマークされたインポートタスクを削除します。

# インポートタスクとデバイスオンボーディングステータスの表示
<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` パラメータを使用して、追加のステータス詳細を取得することもできます。
+ 

**初期化**  
AWS IoT Core for Amazon Sidewalk は、ワイヤレスデバイスのインポートタスクリクエストを受信し、タスクをセットアップ中です。
+ 

**初期化**  
AWS IoT Core for Amazon Sidewalk はインポートタスクのセットアップを完了し、シリアル番号 (SMSN) を使用してデバイスをインポートし、タスクの処理を続行するために、制御ログが届くのを待っています。
+ 

**保留中**  
インポートタスクはキューで処理を待機中です。AWS IoT Core for Amazon Sidewalk は、処理キューにある他のタスクを評価しています。
+ 

**完了**  
インポートタスクが処理され、完了しました。
+ 

**FAILED**  
インポートタスクまたはデバイスタスクが失敗しました。`StatusReason` パラメータを使用して、検証例外など、インポートタスクが失敗した理由を特定できます。
+ 

**DELETING**  
インポートタスクは削除対象としてマークされており、削除中です。

## デバイスのオンボーディングステータス
<a name="bulk-provisioning-status-devices"></a>

インポートタスクに追加した Sidewalk デバイスには、次のステータスメッセージのいずれかが表示されます。ステータスは、デバイスをオンボードする準備ができているか、オンボード済みか、オンボードに失敗したかを示します。AWS IoT コンソールまたは AWS IoT Wireless API オペレーション、`ListDevicesForWirelessDeviceImportTask` の `OnboardingStatusReason` パラメータを使用して、追加のステータス詳細を取得することもできます。
+ 

**初期化**  
AWS IoT Core for Amazon Sidewalk はインポートタスクのセットアップを完了し、シリアル番号 (SMSN) を使用してデバイスをインポートし、タスクの処理を続行するために、制御ログが届くのを待っています。
+ 

**保留中**  
インポートタスクは、処理と、タスクへのデバイスのオンボーディングが開始されるのをキューで待機しています。AWS IoT Core for Amazon Sidewalk は、処理キューにある他のタスクを評価しています。
+ 

**オンボード済み**  
Sidewalk デバイスはインポートタスクに正常にオンボードされました。
+ 

**FAILED**  
インポートタスクまたはデバイスタスクが失敗し、Sidewalk デバイスがタスクへのオンボードに失敗しました。`OnboardingStatusReason` パラメータを使用して、デバイスのオンボーディングが失敗した理由に関する追加情報を取得できます。