• ドキュメント
• SORACOM Inventory
• Getting Started

SORACOM Inventory で管理するデバイスから SORACOM Harvest Data にデータを送信する

Inventory で管理するデバイスで、SORACOM Air (IoT SIM など) やデバイスエージェントを使用することなく Harvest Data にデータを蓄積し、可視化できます。デバイスエージェントを使用しない場合は、Inventory にデバイスを登録したときに払い出されるデバイス ID とデバイスシークレットを使用して、HTTP リクエストで Harvest Data にデータを送信します。

ステップ 1: Inventory にデバイスを登録する

Inventory にデバイスを登録します。このデバイスを、Inventory デバイスと呼びます。

1. ユーザーコンソール にログインして、データを送信する Harvest Data のカバレッジタイプを選択します。

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

2. [メニュー] → [SORACOM INVENTORY] → [デバイス管理] の順にクリックします。

3. [＋デバイスを追加] をクリックします。

   

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

   項目	説明
   [名前]	デバイスの名前を入力します。
   [グループ]	Inventory デバイスが所属するグループ (Inventory グループ) を選択します。「新しいグループを作成」を選択すると、Inventory グループを作成 できます。

   

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

   Inventory デバイスが作成され、デバイス ID、デバイスキー ID、シークレットキーが表示されます。必ずメモしてください。

   

6. [閉じる] をクリックします。

ステップ 2: グループを設定する

ステップ 1: Inventory にデバイスを登録する で選択した Inventory グループで、Harvest Data を有効化します。詳しくは、SORACOM Harvest Data を有効化する を参照してください。

ステップ 3: Harvest Data にデータを送信する

ステップ 1: Inventory にデバイスを登録する でメモしたデバイス ID (${device_id}) およびシークレットキー (${secret_key}) を指定して、Harvest Data にデータを送信します。

以下のいずれかの方法で Harvest Data に送信できます。

• Harvest Data にリクエストボディで JSON を送信する例:

  POST リクエストで送信します。シークレットはヘッダーに指定します。

  $ curl -X POST https://g.api.soracom.io/v1/devices/${device_id}/publish \
  -H "x-device-secret: ${secret_key}" \
  -d '{
    "temperature": 20
  }' 
  

• Harvest Data にクエリパラメータでデータを送信する例 (1):

  GET リクエストで送信します。シークレットキーは、ヘッダーに指定します。データは、URL エンコーディングして、クエリパラメータに指定します。

  $ curl -X GET "https://g.api.soracom.io/v1/devices/${device_id}/publish?temperature=21" \
  -H "x-device-secret: ${secret_key}"
  

• Harvest Data にクエリパラメータでデータを送信する例 (2):

  GET リクエストで送信します。シークレットキーとデータは、URL エンコーディングして、クエリパラメータに指定します。

  $ url_encoded_secret_key=$(python3 -c "import sys, urllib.parse; print(urllib.parse.quote_plus('${secret_key}'))")
  $ curl -X GET "https://g.api.soracom.io/v1/devices/${device_id}/publish?device_secret=${url_encoded_secret_key}&temperature=22"
  

Harvest Data のデータを確認する

1. ユーザーコンソール にログインし、データを送信した Inventory デバイスにあわせてカバレッジタイプを変更します。

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

2. [メニュー] → [SORACOM INVENTORY] → [デバイス管理] の順にクリックします。

   デバイス管理画面が表示されます。

3. データを送信した Inventory デバイスにチェックを入れ、[操作] → [データを確認] の順にクリックします。

   SORACOM Harvest Data 画面が表示されます。SORACOM Harvest Data 画面の操作については、SORACOM Harvest Data に保存したデータを確認 / 削除する を参照してください。