• ドキュメント
• SORACOM Harvest
• Getting Started with SORACOM Harvest Files

デバイスのファイルを Harvest Files に送信する

このページでは、Harvest Files を使ってデバイスのファイルを SORACOM プラットフォームに保存し、そのファイルを SORACOM ユーザーコンソールで確認する手順を紹介します。

ステップ 1: Harvest Files を有効化する

デバイスのファイルを Harvest Files に保存する場合は、デバイスに取り付けた IoT SIM が所属するグループで Harvest Files を有効化します。詳しくは、Harvest Files を有効化する を参照してください。

ステップ 2: デバイスからファイルを Harvest Files に送信する

デバイスから HTTP で送信する

Harvest Files の HTTP (セルラー通信経由のアップロード) のエントリポイント に、IoT SIM を利用するデバイスから HTTP POST もしくは PUT リクエストを送信します。

保存パス (/logs/abc.png) を指定する例:

送信したファイル「a.png」は、/logs/abc.png に保存されます。送信するファイルの名前やパスは適宜読み替えてください。

$ curl -v -X PUT http://harvest-files.soracom.io/logs/abc.png \
-H "Content-type: image/png" \
--data-binary @a.png

import requests

header = {"Content-Type": "image/png"}
with open("/path/to/a.png", "rb") as image:
  response = requests.post("http://harvest-files.soracom.io/logs/abc.png", headers=header, data=image)
  print(response.status_code)
  print(response.text)

$ curl -v -X PUT http://harvest-files.soracom.io/ \
-H "content-type:image/png" \
--data-binary @a.png

$ curl -X PUT http://harvest-files.soracom.io \
-H "content-type:text/plain" \
--data-binary @a.txt

{"message":"Invalid path. request path: /, configured path "}

デバイスで SORACOM API を呼び出して送信する

SORACOM API でも、Harvest Files にファイルをアップロードできます。

保存パス (/sample/test.sh) を指定する例:

送信したファイル「test.sh」は、/sample/test.sh に保存されます。

${X_SORACOM_API_KEY} や ${X_SORACOM_TOKEN} の取得方法は、SORACOM API 利用ガイド を参照してください。

$ curl -X PUT "https://api.soracom.io/v1/files/private/sample/test.sh" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}" \
-H "Content-Type: text/x-sh" \
--data-binary @test.sh 

ステップ 3: Harvest Files に収集されたファイルを確認する

SORACOM ユーザーコンソールでは、Harvest Files で保存されたファイルを確認およびダウンロードできます。

SORACOM ユーザーコンソールのメニューから「SORACOM Harvest Files」を選択します。

保存されたファイルは当メニューから確認およびダウンロードできます。

デバイスで以下のコマンドを実行しても、ファイルを確認できます。

$ curl -v -X GET http://harvest-files.soracom.io

ステップ 4: デバイスで Harvest Files のファイルをダウンロードする

デバイス側からは以下の例のようにファイルのダウンロードが可能です。

curl -O http://harvest-files.soracom.io/sample/test.sh

また、以下の例のようにファイルのメタ情報を確認できます。ETag (エンティティタグ) もあるため、定期的に監視して変更があった時のみにダウンロードするという応用も考えられます。

(例)

$ curl -I http://harvest-files.soracom.io/sample.txt
HTTP/1.1 200 OK
Date: Tue, 13 Aug 2019 08:26:47 GMT
Content-Type: plain/text
Content-Length: 0
Connection: close
ETag: aa79f62afe95f7f550dff6e544bbb69e