SORACOM Developers

SORACOM Harvest Files でデバイスのファイルをクラウドに送信する

はじめに

SORACOM Harvest Files(以下、Harvest Files)とは、IoT デバイスからのファイルを収集し可視化するサービスです。SORACOM Air が提供するセルラー通信を使って、IoT デバイスの画像やログファイル等を手間なくクラウドにアップロードできます。

Getting Started

このドキュメントでは、Harvest Files を使ってデバイスのファイルをクラウドに保存し、そのファイルをコンソールで確認する手順を紹介します。

セットアップから動作確認と後片付けまで 4 つのステップに分かれています。

当ガイドの前提は以下のとおりです。

ステップ 1: デバイスのファイルを Harvest Files に送信する

Harvest Files は、設定を有効化すればすぐにファイルを送信できます。Harvest Files の設定を有効化した状態で、SORACOM Air の SIM から通信を行っているデバイスから、Harvest Files のエントリポイントへファイルを送信すると SORACOM のプラットフォーム上にファイルが保存されていきます。

Harvest Filesを有効化する

Harvest Files を有効化します。 コンソールにログインして、SIMグループから「SORACOM Harvest Files 設定」で以下のように設定します。

グループ設定の詳細は、SORACOM Harvest : 機能の説明 | ユーザーガイドをご確認ください。

注意
Harvest Files アップロードが完了したファイルのサイズによって料金が発生します。詳しくは料金表を確認してください。

HTTPでファイルを送信する

Harvest Files は HTTP に対応しています。Harvest Filesエントリポイント宛にHTTP POST もしくは PUT リクエストを送信してください。

コマンド例: 以下の場合、送信したファイル「a.png」は、グループ設定で指定したdefaultPathのパス、ファイル名として保存されます。

curl -v -X PUT --data-binary @a.png -H 'content-type:text/plain' http://harvest-files.soracom.io/

以下の場合、パスを指定しているため、送信したファイル「a.png」は、/logs/a.pngとして保存されます。

curl -v -X PUT --data-binary @a.png -H 'content-type:text/plain' http://harvest-files.soracom.io/logs/a.png

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

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

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

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

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Funk

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

SORACOM Krypton

SORACOM Lagoon

SORACOM Napter

Gadgets

Device

サービス機能詳細

Developer Tools

pagetop