「新しいイベントチャネルを作成」画面でイベントソースとして「SORACOM Harvest Files」を選択すると、SORACOM Harvest Files にファイルをアップロード (保存、更新) したり削除したりしたときに、Flux アプリが起動します。
[イベントソース設定]
イベントソースに連結したチャネルにイベントメッセージが送信される条件を設定します。
| 項目 | 説明 |
|---|---|
| この条件を有効化する場合は、チェックを入れます。 | |
| Harvest Files のファイルパスを入力します。ここで指定したパスと前方一致したファイルがイベントの対象です。 | |
ファイルの変化の種類を選択します。ここでチェックを入れたイベントが検知されたときにイベントメッセージが送信されます。
|
SORACOM Harvest Files イベントソースを利用したチャネルは、オペレーターごとに 10 個まで作成できます。
チャネルに送信されるデータ
SORACOM Harvest Files イベントソースを設定したチャネルに送信されるデータは、MESSAGE と CONTEXT です。
実際に Flux アプリに送信されたデータは、SORACOM Flux Studio の タブで確認できます。詳しくは、実行履歴 (ログ) を参照してください。
MESSAGE
Harvest Files で発生したイベントと、変化があったファイルパスです。
{
"eventType": "updated",
"path": "/harvest-files-path/filename",
"contentType": "image/jpeg",
"presignedUrls": {
"get": "https://harvest-files.s3.ap-northeast-1.amazonaws.com/xxx"
}
}
| 項目 | 説明 |
|---|---|
eventType | 発生したイベントタイプ。以下のいずれかです。
|
path | ファイルパス。ファイル名を含みます。 |
contentType | ファイルの contentType。 |
presignedUrls.get | 作成または更新されたファイルを取得するための URL。ファイルが削除されたときは含まれません。 URL の有効期限は、イベントの発生から 1 時間です。 |
アクションで、イベントソースの MESSAGE を参照する場合は、${event.payload.<json パス>} や event.payload.<json パス> == 1 のように入力します。
CONTEXT
{
"eventType": "harvest_files",
"configurationId": "01J1CH2MJRVxxxxxxxxxxxxxxx"
}
| 項目 | 説明 |
|---|---|
eventType | イベントの種類。SORACOM Harvest Files にファイルをアップロード (保存、更新) したり削除したりしたことが、Flux アプリが起動するトリガーになった場合は、harvest_files です。 |
configurationId | SORACOM Harvest Files イベントソースの設定ごとに異なる ID。Harvest Files で発行されます。 |
上記の CONTEXT を、アクションで参照する場合は、${event.context.<json パス>} や event.context.<json パス> == "xxxxx" のように入力します。