Soracom

画像を取得するソラカメ対応カメラのデバイス ID (例: 001A2B3C4D5E) を入力します。デバイス ID を確認するには、デバイス管理画面でソラカメ対応カメラの情報を確認 / 検索する を参照してください。

• この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.xxxxxx}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.xxxxxx}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。

取得する画像の時刻を "2025-05-01T01:23:00Z" のような文字列、または UNIX 時間 (ミリ秒) で指定します。指定しない場合は、アクションが実行されたときの現在時刻の画像が取得されます。

• この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.time}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.time})、時刻を表す式 (例: ${addMinutes(now(), -5)}) を入力できます。入力できる式について詳しくは、 アクション、コンディションの記法 を参照してください。

SORACOM Harvest Files にエクスポートする場合は、チェックを入れます。

• [保存先のディレクトリを指定する] に、SORACOM Harvest Files にエクスポートするときに静止画を保存するパス (ディレクトリ) を入力します。

  以下の文字を入力すると、エクスポート時にルールに従って置き換えられます。この表記では { の前に $ を入力しないでください。

  • {export_id}: エクスポート ID (例: 123e4567-e89b-12d3-a456-426614174000)。
  • {device_id}: デバイス ID (例: 001A2B3C4D5E)。
  • {date}: エクスポートのリクエスト日時 (例: 2024/10/01/12/34)。年、月、日、時、分のディレクトリを作成するために、区切り文字はすべて「/」です。
  • {time}: 静止画の撮影日時 (UNIX 時間 (ミリ秒)) (例: 1728393803000)。

  たとえば、「/sora_cam/{device_id}」を入力すると、ソラカメ対応カメラごとに異なるディレクトリにエクスポートされます。また、{date} や {time} は、複数のソラカメ対応カメラで同じ時刻にエクスポート/撮影された静止画を、同じディレクトリに保存する場合に便利です。

  なお、空欄にした場合や、半角スペースを指定した場合は、Harvest Files のルートディレクトリにエクスポートされます。

  • この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.deviceid}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.deviceid}) を入力できます。入力できる式について詳しくは、 アクション、コンディションの記法 を参照してください。

ソラカメ画像取得アクションは、SORACOM API を利用します。ここでは、「ソラカメ画像取得アクションで利用される SORACOM API」を実行する (API の実行権限がある) SAM ユーザーを作成、または選択します。

• 新しく SAM ユーザーを作成する場合は、[新しく SAM User を作成する] をクリックして、[SAM User 名] に SAM ユーザーの名前を入力します。

  なお、新しく SAM ユーザーを作成する場合は、「ソラカメ画像取得アクションで利用される SORACOM API」が実行できるように、SAM ユーザーの [権限設定] と [信頼ポリシー] が自動的に設定されます。

  • SAM ユーザーの [権限設定] で、「ソラカメ画像取得アクションで利用される SORACOM API」の実行が許可されます。

    

  • SAM ユーザーの [信頼ポリシー] で、Flux アプリが SAM ユーザーの権限で「ソラカメ画像取得アクションで利用される SORACOM API」を実行することが許可されます。

    

• 既存の SAM ユーザーから選択する場合は、あらかじめ SAM ユーザーの [権限設定] と [信頼ポリシー] を以下のように設定してから、ソラカメ画像取得アクションの [既存の SAM User から選択する] をクリックして、[SAM User] で既存の SAM ユーザーを選択します。

  1. SAM ユーザーの [権限設定] で、「ソラカメ画像取得アクションで利用される SORACOM API」の実行を許可します。

     [SORACOM Harvest Files にエクスポートする] にチェックを入れた場合:

     {
       "statements": [
         {
           "effect": "allow",
           "api": [
             "SoraCam:exportSoraCamDeviceRecordedImage",
             "SoraCam:getSoraCamDeviceExportedImage",
             "OAuth2:authorize",
             "FileEntry:putFile"
           ]
         }
       ]
     }
     

     [SORACOM Harvest Files にエクスポートする] にチェックを外した場合:

     {
       "statements": [
         {
           "effect": "allow",
           "api": [
             "SoraCam:exportSoraCamDeviceRecordedImage",
             "SoraCam:getSoraCamDeviceExportedImage",
             "OAuth2:authorize"
           ]
         }
       ]
     }
     

  2. SAM ユーザーの [信頼ポリシー] で、Flux を信頼するように設定します。

     例:

     {
       "statements": [
         {
           "effect": "allow",
           "principal": {
             "service": [
               "Flux"
             ]
           }
         }
       ]
     }