--- title: "EventBridge 入力トランスフォーマーの使い方：InputTemplateでSNS・Slack通知を整形する" url: "https://www.issoh.co.jp/tech/details/18439/" published: 2026-10-17 updated: 2026-10-17 categories: ["AWS"] publisher: "株式会社一創" --- # EventBridge 入力トランスフォーマーの使い方：InputTemplateでSNS・Slack通知を整形する EventBridgeのルールが拾ったイベントをそのままSNSへ流すと、メールにはJSONが丸ごと届きます。入力トランスフォーマーは、イベントから必要な値だけを抜き出し、テンプレートに埋めてからターゲットへ渡す機能です。本記事では`InputPathsMap`と`InputTemplate`の書き方、引用符と型の規則、CodePipelineの失敗をSNSメール・Amazon Q Developer・Slack Incoming Webhookへ届ける設定例、Lambdaへ切り替える判断までを公式ドキュメントに沿って整理しました。EventBridge全体の仕組みは[Amazon EventBridgeとは？仕組み・料金とCLI・Pythonでの実装手順](https://www.issoh.co.jp/tech/details/15513/)に譲ります。仕様と上限値は2026年10月時点の記載です。 ## まとめ：入力トランスフォーマーは引用符の規則を押さえ、通知先の形に合わせて組む 入力トランスフォーマーは、変数を定義する`InputPathsMap`と、変数を埋める`InputTemplate`の2つで構成されます。詰まりやすいのは構文より引用符の扱いです。JSONテンプレートでは文字列の変数に引用符を付けなくてもよく、オブジェクトや配列を指す変数には付けてはいけません。存在しないパスの変数は黙って出力から消え、抜き出した値はエスケープされずに埋め込まれます。 通知先は3通りから選びます。メールで足りるならSNSに文字列テンプレートを渡す。Slackのチャンネルへ整った体裁で出したいなら、Amazon Q Developerのカスタム通知スキーマへ変換してSNS経由で送る。SNSを挟まずに直接投稿したいときはAPI送信先でIncoming WebhookへPOSTします。値に引用符や改行が混じる、日本時間への変換や条件分岐が要る、といった通知はテンプレートで粘らずLambdaで組むほうが安全です。 ## 入力変換の仕組み｜InputPathsMapとInputTemplateの役割と上限 最初に、設定項目の役割と上限値、ほかの入力指定との関係を押さえます。 ### InputPathsMapからInputTemplateへの変数展開と100個の上限 [公式の入力変換ページ](https://docs.aws.amazon.com/ja%5Fjp/eventbridge/latest/userguide/eb-transform-target-input.html)によると、入力パスでJSONパスを使って元イベントの値を変数に入れ、入力テンプレートの中で山括弧に変数名を入れて参照します。変換後のイベントが元のイベントの代わりにターゲットへ送られる。変数は最大100個まで定義できます。 [APIリファレンスのInputTransformer](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API%5FInputTransformer.html)には細かい上限が並びます。`InputTemplate`は1〜8,192字、`InputPathsMap`は100組まで、キーと値はそれぞれ256字まで、キーは`AWS.`で始められません。JSONパスはルール作成時に検証されないため、綴りの誤りは保存できてしまう点も頭に入れておきます。 JSONパスの書き方は、2つの文書で表現が食い違っている点に気をつけてください。APIリファレンスは「ブラケット記法ではなくドット記法」と書く一方、ユーザーガイドは配列のインデックスを対応構文に挙げ、`$.resources[0]`を例に使っています。キーはドットでつなぎ、角括弧は配列のインデックスにだけ使う書き方にしておけば、どちらの記載にも沿います。 ### 予約変数aws.events.rule-nameなど5種類の中身と使える位置の違い パスを定義しなくても使える予約変数が5つあり、同じ名前の変数は作れません。 - `aws.events.rule-arn`：ルールのARN（文字列内・JSONの値のどちらにも置ける） - `aws.events.rule-name`：ルール名（同上） - `aws.events.event.ingestion-time`：EventBridgeがイベントを受け取った時刻、ISO 8601形式（同上） - `aws.events.event`：`detail`を除いた元イベント（JSONの値にだけ置ける） - `aws.events.event.json`：`detail`を含む元イベント全体（JSONの値にだけ置ける） 最後の2つは中身がエスケープされないため、JSONフィールドの値としてしか置けません。通知文の末尾に「元イベント全文」を文字列で添える、という使い方はできない仕様です。ルール名を文面に入れておくと、どのルールが送った通知かを受信側で追えます。 ### Input・InputPathとの排他関係と別アカウントのバス宛てで使えない制約 [put-targetsのリファレンス](https://docs.aws.amazon.com/cli/latest/reference/events/put-targets.html)では、`Input`（固定のJSON）・`InputPath`（イベントの一部をそのまま渡す）・`InputTransformer`はターゲットの排他パラメータです。`detail`だけを渡したいなら`InputPath`の`$.detail`で済み、整形が要るときだけ入力トランスフォーマーを使います。 別のAWSアカウントのイベントバスをターゲットにした場合、この3つはどれも使えません。アカウントをまたいで集約する構成では、受け側のアカウントのルールで変換します。集約側バスのリソースポリシーや送信側ロールの権限設定は、[EventBridge イベントバスの使い分け：クロスアカウント・リージョン送信のポリシー設定](https://www.issoh.co.jp/tech/details/18441/)にまとめています。また、ターゲットのURLパスなどに値を差し込む動的パスパラメータは、変換後ではなく元のイベントを参照します。 ## InputTemplateの書き方｜文字列とJSONで変わる引用符と型の扱い テンプレートは文字列とJSONのどちらでも書けます。引用符の扱いが両者で違うため、ここが最初のつまずきどころになります。 ### 文字列テンプレートとJSONテンプレートで変わる引用符の付け方と出力例 元イベントが`"detail": {"instance-id": "i-0123456789", "state": "RUNNING"}`で、変数`instance`と`state`を定義した場合の出力を、公式の例から抜き出しました。矢印の左がテンプレート、右が出力です。 ``` # 文字列テンプレート "instance is in " => "instance i-0123456789 is in RUNNING" # JSONテンプレート（文字列の変数は引用符なしでよい） {"instance": } => {"instance": "i-0123456789"} # JSONテンプレート（文字列の中に埋める） {"msg": "state is "} => {"msg": "state is RUNNING"} ``` 文字列テンプレートは全体を二重引用符で囲みます。JSONテンプレートでは、文字列を指す変数は引用符なしで書けばEventBridgeが自動で引用符を補います。付けても許容されますが、どちらかに揃えておくと読み違いが減る。文字列の中で引用符を出したいときは`\"`と書きますが、公式によるとコンソールとAWS CLIで結果が変わり、CLIではバックスラッシュがさらにエスケープされます。 ### オブジェクトや配列を指す変数を文字列に埋めると引用符が消える落とし穴 変数が`$.detail`のようにオブジェクトや配列を指す場合、引用符を付けてはいけません。`"Detail is "`のように文字列の中へ埋めると、EventBridgeは有効な文字列にするため内側の引用符を取り除きます。結果はJSONとして読めない文字列です。 オブジェクトをそのまま渡したいときは`{"detail": }`のようにJSONの値として置きます。テンプレートがJSONの場合、プレースホルダーをオブジェクトのキーには使えません。`{: "x"}`のようにキー名を動的に変える書き方は通らないので、キーは固定にします。 ### 存在しないパスの変数は出力から消え、値はエスケープされない2つの注意 公式の「よくある問題」に、通知用途で効いてくる2点があります。1つ目は、イベントに存在しないパスを指す変数は作られず、出力にも現れないことです。エラーにはならず、該当箇所が空のまま届く。サービスによってはイベントの種類でフィールドの有無が変わるため、通知文に入れる項目は、拾うイベントすべてに存在するものから選びます。 2つ目は、入力パスで抜き出した値がエスケープされずにテンプレートへ入ることです。コミットメッセージのように利用者が書いた文字列は、二重引用符や改行を含むことがあります。JSONテンプレートにそのまま埋めると出力がJSONとして壊れうるため、自由記述の値を通知に載せるかどうかは判断章で扱う基準で決めます。 ## SNSのメール通知を読める文章に整形する手順｜CodePipelineの失敗を例に ここからは[AWS CodePipeline](https://www.issoh.co.jp/tech/details/3107/)のデプロイ失敗を例に、設定を組み立てます。 ### CodePipelineのアクション失敗イベントから項目を抜き出す変数定義 [CodePipelineのイベント一覧](https://docs.aws.amazon.com/codepipeline/latest/userguide/detect-state-changes-cloudwatch-events.html)では、パイプライン単位の失敗イベントの`detail`にあるのはパイプライン名・実行ID・状態などで、どのステージで落ちたかは入っていません。`failedStage`などの項目は、通知機能が処理した後のイベントにだけ付く項目です。ステージ名と失敗の要約を載せたいなら、アクション単位の`CodePipeline Action Execution State Change`を拾います。ルールのパターンは公式例をそのまま使えます。 ``` { "source": ["aws.codepipeline"], "detail-type": ["CodePipeline Action Execution State Change"], "detail": { "state": ["FAILED"], "type": { "category": ["Deploy", "Build"] } } } ``` アクションの失敗イベントには`detail.stage`・`detail.action`・`detail.execution-result.external-execution-summary`・`external-execution-url`が入ります。パターンの演算子の書き方は[EventBridge イベントパターンの書き方](https://www.issoh.co.jp/tech/details/18424/)で詳しく扱っています。 ### 複数行の通知文を行ごとの二重引用符で組みput-targetsで登録する メールで読む文章にする場合に使うのは、文字列テンプレートです。公式は、複数行の文字列を出すときは各行を二重引用符で囲むよう案内しています。JSONファイルに書く場合、行の区切りは`\n`で表します。 ``` [ { "Id": "notifyMail", "Arn": "arn:aws:sns:ap-northeast-1:123456789012:deploy-alerts", "InputTransformer": { "InputPathsMap": { "pipeline": "$.detail.pipeline", "stage": "$.detail.stage", "action": "$.detail.action", "summary": "$.detail.execution-result.external-execution-summary", "url": "$.detail.execution-result.external-execution-url", "time": "$.time" }, "InputTemplate": "\"[FAILED] / / \"\n\"Summary: \"\n\"Detail: \"\n\"Time (UTC):