Soracom

ここでは、グループの Harvest Data 設定を有効化する手順を説明します。

Air (セルラー、LoRaWAN、Sigfox)、Arc、Inventory を利用するデバイスで Harvest Data を利用するには、グループ を作成し、グループの Harvest Data 設定を有効化して、そのグループにデバイスを所属させます。

1. SIM グループ画面、LoRaWAN グループ画面、Sigfox グループ画面、またはデバイスグループ画面で [SORACOM Harvest Data 設定] をクリックします。

   各画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。

2. スイッチをクリックして「on」にします。

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

   項目	説明
   [一括書き込み]	Harvest Data に対して 1 回のデータ送信で、複数のデータをまとめて書き込む機能を利用する場合に有効化します。詳しくは、1 回のデータ送信で複数のデータを書き込む (一括書き込み) を参照してください。
   [送信データの時刻をタイムスタンプに利用する]	「送信データに含めた時刻」をタイムスタンプとして利用する場合に有効化します。詳しくは、「送信データに含めた時刻」をタイムスタンプとして利用する を参照してください。

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

   SORACOM Harvest Data 設定を「on」にした場合は、確認画面が表示されます。

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

   

6. IoT SIM、LoRaWAN デバイス、Sigfox デバイスが所属するグループを切り替えます。

   IoT SIM、LoRaWAN デバイス、Sigfox デバイスから送信したデータが Harvest Data に保存できるようになります。

Harvest Data を無効化する

Harvest Data は有料のサービスです。Harvest Data が有効になっていると IoT SIM 1 枚ごとにオプション料金が発生します。ここでは、グループの設定を変更して、Harvest Data を無効にする手順を説明します。

1. SIM グループ画面で [SORACOM Harvest Data 設定] をクリックします。

   SIM グループ画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。

2. スイッチをクリックして「off」にします。

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

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、Harvest Data の設定を変更できます。

$ soracom groups put-config --group-id {group_id} --namespace SoracomHarvest \
--body '[
  {
    "key": "enabled",
    "value": true
  }
]'

$ soracom groups put-config --group-id {group_id} --namespace SoracomHarvest \
--body '[
  {
    "key": "enabled",
    "value": false
  }
]'

$ curl -v -X PUT https://api.soracom.io/v1/groups/{group_id}/configuration/SoracomHarvest \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '[
  {
    "key": "enabled",
    "value": true
  }
]'

$ curl -v -X PUT https://api.soracom.io/v1/groups/{group_id}/configuration/SoracomHarvest \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '[
  {
    "key": "enabled",
    "value": false
  }
]'

ボディで指定するプロパティについて

以下の key と value のペアを配列で指定します。