Soracom

ここでは、バッチ処理で複数の IoT SIM のステータスを「使用中 (active)」に変更する実行手順を示します。

ステップ 1: CSV ファイルを用意する

ステータスを「使用中 (active)」に変更する IoT SIM の一覧として SIM ID が記載された CSV ファイルを準備します。有効なリソース ID (IoT SIM の SIM ID など) を正しく入力してください。

simId
8942310XXXXXXX00000
8942310XXXXXXX00001
8942310XXXXXXX00002

CSV ファイルの要件は、利用する SORACOM API ([API] と [メソッド] の組み合わせで指定) によって異なります。詳しくは、CSV ファイルの要件 を参照してください。

ステップ 2: バッチグループを作成する

IoT SIM のステータスを「使用中 (active)」に変更するジョブを管理するためのバッチグループを作成します。「ジョブ」および「バッチグループ」については、バッチ処理の特徴 を参照してください。

1. ユーザーコンソール にログインし、対象の IoT SIM にあわせてカバレッジタイプを変更します。

   たとえば、plan01s の IoT SIM のステータスを変更する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

2. [メニュー] → [バッチ処理] → [バッチグループ] の順にクリックします。

   バッチグループ画面が表示されます。

3. [バッチグループ作成] をクリックします。

   

4. 以下の項目を設定します。

   項目	説明
   [バッチグループ]	作成するバッチグループの名前を入力します。例: IoT SIM ステータス変更 01
   [説明]	バッチグループの説明を入力します。

   

5. [保存] をクリックします。

   バッチグループが作成されます。

   バッチグループを編集/削除するには

   • バッチグループを編集するには、[] → [編集] の順にクリックします。
   • バッチグループを削除するには、[] → [削除] → [バッチグループ削除] の順にクリックします。

ステップ 3: ジョブを開始する

IoT SIM のステータスを「使用中 (active)」に変更するジョブを作成します。1 つのバッチグループには複数のジョブを作成できます。

1. バッチグループ画面でバッチグループ名をクリックします。

   バッチジョブ画面が表示されます。

2. [＋ジョブ作成] をクリックします。

   

3. 以下の項目を設定します。

   項目	説明
   [ジョブ名]	任意の名前を入力します。例: 「使用中 (Active)」に変更します
   [API]	API グループを選択します。ここでは、「SIM」を選択します。
   [メソッド]	API を選択します。ここでは、「activateSim」を選択します。

   なお、[API] で「SIM」を選択し、[メソッド] で「activateSim」を選択した場合は、Sim:activateSim API が実行されます。

   

4. [ファイルの選択] をクリックして、ステップ 1: CSV ファイルを用意する で準備した CSV ファイルを選択します。

   CSV ファイルがアップロードされます。

5. [sim_id] で、CSV ファイルのデータの何列目に、処理対象のデータ (例: SIM ID) が含まれるかを選択します。ここでは、「Column 1: simId」を選択します。

   

   [Import:] に、IoT SIM の SIM ID が表示されます。この表の 1 行が 1 つのタスクです。ジョブを開始すると、タスクが上から順に実行されます。

   [sim_id] で「- Not assigned -」を選択すると、ジョブは開始できません。

6. [エラー発生時の処理] を選択します。

   項目	説明
   [エラーが発生した場合はジョブの実行を終了する]	1 つでもタスクが失敗すると、ジョブを中止します。失敗したあとのタスクは実行されません。
   [エラーが発生した場合でもジョブの実行を継続する]	タスクが失敗しても、ジョブの実行が継続します。

7. [ジョブを開始] をクリックします。

ステップ 4: ジョブの実行結果を確認する

1. バッチジョブ画面で、ジョブ名をクリックします。

   ジョブ詳細画面が表示されます。

   

   項目	説明
   [ジョブ名]	ジョブ名。
   [ID]	ジョブ ID。
   [API]	CSV ファイルで指定したリソースに対して実行する API。ジョブを開始するときに、[API] と [メソッド] で指定します。
   [エラー発生時の処理]	ジョブを開始するときに [エラー発生時の処理] で選択した項目。
   [ステータス]	ジョブの実行状態 (ステータス) が表示されます。 表示 説明 PENDING ジョブの開始を待っています。 RUNNING ジョブが実行中です。 COMPLETED ジョブが終了し、すべてのタスクが成功しました。 ABORTED 1 つのタスクが失敗したためジョブを中止しました。 FAILED ジョブが終了し、すべてのタスクを実行しましたが、1 つ以上のタスクが失敗しました。
   [開始日時]、[終了日時]	ジョブの開始日時と終了日時。 ジョブの実行時間はシステムの状況によって異なります タスクの件数が同じでも、ジョブの実行時間はシステムの状況によって異なります。
   [タスク結果] (概要)	タスクの実行状態 (ステータス) ごとに、タスクの件数が表示されます。 項目 説明 TOTAL タスクの件数。 SUCCESS 成功したタスクの件数。 ERROR 失敗したタスクの件数。 PENDING 実行前のタスクの件数。
   [タスク結果] (詳細)	タスクの結果が一覧表示されます。 フィルタリング条件を指定して、[追加] をクリックすると、タスクのステータスやリソース ID でフィルタリングできます。 [] をクリックすると、一覧に表示されているリソース ID を CSV ファイルでダウンロードできます。