論よりコード (TL;DR)

Azure Logic Apps の Request トリガーで受け取った HTTP ヘッダは triggerOutputs()['headers'][HTTP_HEADER_KEY] で読み出せる。

例) User-Agent という HTTP ヘッダを読み出したければ

@{triggerOutputs()?['headers']?['User-Agent']}

と、アクションのフィールドに設定すればよい。

注) 書式としては triggerOutpus() だが、アクションのフィールドに指定する時は "式" として認識させるため @{ ... } で囲む。

triggerOutputs() 関数は、トリガーで受け取ったアウトプットを構造として出力するため、[KEY] でオブジェクトを指定すれば値が読み出せる。

Logic Apps の [概要] > [実行の履歴] で "HTTP 要求の受信時" を開いた後、 "出力" の [未加工出力の表示] が triggerOutputs() で見ることができる構造となる。

curl -H "Content-Type: application/json" -H "X-Custom-1: cust-data1" -d '{"data": 3}' $URL

とした場合は、このような出力になる。

ここまで見なくとも、基本的な構造は受信要求からコンテンツを参照するにも書かれているように headers と body をトップとした構造となっている。

User-Agent を読み出す場合は

triggerOutputs()['headers']['User-Agent']

で良いのだが、この時 User-Agent が存在しない場合は InvalidTemplate が発生する。

キーが存在しない場合の InvalidTemplate を無視したいときに利用できるのが ? である。
キーが存在しない可能性がある参照の先頭に ? を入れるだけ。

triggerOutputs()['headers']?['User-Agent']

もちろん階層で指定も可能なため、

triggerOutputs()?['headers']?['User-Agent']

と triggerOutputs() で headers が無い場合、そしてその下の参照で user-agent がない場合、と表現可能。

triggerOutputs()['headers']['User-Agent']

となっていたら user-agent USER-AGENT どれでもマッチする。

最後に: Azure Logic Apps とは？

Azure Logic Apps(以下、Logic Apps) は、最近流行話題となっているノーコード・ローコードを実現するサービスです。
※ ノーコード・ローコード自体についてはノーコード・ローコードのあれこれの解説がわかりやすいかもです。

Logic Apps はトリガーによってワークフロー(アクションをつなげたロジック)を実行する仕組みとなっており、似ているものとしては Node-RED があります。

トリガーは色々用意されてますが、中でもわかりやすいのは Request トリガーです。これを設定すると URL が発行され、その URL に HTTP リクエストすることでワークフローが起動できる、いわゆる Webhook¹ です。

SORACOM Beam では SIM に紐づいている番号 "IMSI" を X-SORACOM-IMSI として HTTP ヘッダに付けながらデータ転送できます。それが読めたら嬉しいよね！っていう理由です。

SORACOM Beam ではこんな HTTP ヘッダを付けることができます。詳しくは SORACOM Beam の開発者向けマニュアルをご覧ください。

header	意味
X-SORACOM-IMSI	SIM の IMSI
X-SORACOM-IMEI	通信したモデムの IMEI
X-SORACOM-OPERATOR-ID	SORACOM のアカウント(オペレーター) ID
X-SORACOM-TIMESTAMP	SORACOM でデータを受け取ったタイムスタンプ(エポックミリ秒)
X-SORACOM-SIGNATURE	SHA256 署名
X-SORACOM-GEO-POSITION	簡易位置測位機能による緯度経度

ノーコード！ローコード！

EoT