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

SORACOM Harvest Files にファイルをアップロードする

デバイスのファイルを Harvest Files にアップロードする

Harvest Files を使ってデバイスのファイルを SORACOM に保存する手順を紹介します。

デバイスから 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

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

SORACOM API を呼び出して送信する

サーバーなど、IoT SIM を利用しないシステムでも、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 

ユーザーコンソールでファイルを Harvest Files にアップロードする

1. ユーザーコンソール にログインし、ファイルが保存されているカバレッジタイプを変更します。

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

2. [メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Files] の順にクリックします。

   

   SORACOM Harvest Files の画面が表示されます。

3. [アップロード] をクリックします。

   

4. [参照] をクリックして、ファイルを選択します。

   

   [アップロード先のフルパス] に「/」と選択したファイルのファイル名が表示されます。

5. [アップロード先のフルパス] にアップロード先のフルパスを入力して、[アップロード] をクリックします。

   たとえば、「/path/to/test.jpg」を入力すると、path ディレクトリと、path ディレクトリの中に to ディレクトリが自動的に作成され、test.jpg がアップロードされます。

   

   ファイルのアップロードが完了すると、アップロードしたファイルが表示されます。

   

   • パンくずリストをクリックすると、上の階層のディレクトリに移動できます。
   • パスを編集して、[開く] をクリックすると、指定したディレクトリに移動できます。

   Harvest Files からダウンロードせずに内容を確認することはできません。ダウンロードする手順について詳しくは、SORACOM Harvest Files からファイルをダウンロード / 削除する を参照してください。

   • アップロードしたときのコンテンツタイプは、手順 4 でファイルを選択したときに決定されます。たとえば、手順 5 で [アップロード先のフルパス] で拡張子を変更しても、コンテンツタイプは変更されません。
   • Harvest Files にファイルをアップロードすると、自動的に Etag (ファイルのエンティティタグ) が設定されます。