Amazon EventBridge Webhookペイロード上限が1MBに拡大
256KB制限を撤廃、大型リソースのインライン受信で二次APIコールを削減
Amazon EventBridge経由のWebhook・Eventsペイロード上限が256KBから1MB(1,000,000バイト)に引き上げられました。2026年11月17日より全APIバージョンに自動適用され、既存のサブスクリプション設定変更は一切不要です。バリアント数の多い商品や明細行の多い注文などの大型リソースがインラインで届くようになり、Admin APIへの二次取得リクエストが削減されます。
1変更前後の比較
1MB(1,000,000バイト)を超えるペイロードは引き続き従来のフォールバック動作(Classicは{"id":...}、Eventsはpayload_url付きスタブ)となります。
2業務に活かせる具体ユースケース
- 課題
- バリアントが数十種類ある商品マスタの同期で、products/update Webhookが256KB超となり毎回
{"id":...}のみ受信。Admin APIへの再取得でレイテンシが増加していた。 - 打ち手
- EventBridgeサブスクリプションはそのままで、1MB以内の商品ペイロードが自動でインライン受信されるようになる。
- 効果
- Admin APIへの二次リクエストが削減されリアルタイム性が向上。在庫・価格同期のタイムラグを短縮できる。
- 技術メモ
- バリアント数が非常に多い場合(1MB超の可能性)は
include_fieldsで必要フィールドを絞り込む対応を検討。
- 課題
- 明細行が多い大口注文のorders/create Webhookで
payload_urlが届き、一時URLへの追加ダウンロード処理が必要だった。URLの有効期限切れによるデータ欠損リスクもあった。 - 打ち手
- 1MB以内の注文ペイロードは自動でインラインに切り替わる。
payload_url対応ロジックは残しつつ、通常フローはシンプル化できる。 - 効果
- 注文処理パイプラインのエラーポイントが減少し、WMSや基幹システムとの連携安定性が向上する。
- 技術メモ
- AWS Lambda等のダウンストリームターゲットが1MB受け入れ可能か事前に確認。必要に応じてEventBridge Input Transformerで絞り込む。
- 課題
- Eventsサブスクリプションで大量の行を含むfulfillmentイベントがpayload_urlで届き、処理ロジックが複雑化していた。
- 打ち手
- 1MB以内のEventsペイロードはインライン受信に変わるため、payload_urlダウンロード分岐が不要になるケースが増える。
- 効果
- フルフィルメント状態の即時反映が可能になり、顧客向けステータス通知の遅延を解消できる。
- 技術メモ
- Events subscriptionの
[events.subscription]クエリセレクションを活用して取得フィールドを限定することでペイロードサイズを管理可能。
3技術者目線のポイント
| 観点 | 詳細 |
|---|---|
| 適用範囲 | 全APIバージョンに自動適用。shopify.app.toml設定・GraphQL Admin API(eventBridgeWebhookSubscriptionCreate / webhookSubscriptionCreate)どちらのサブスクリプションも対象。変更作業不要。 |
| サイズ定義 | 上限は1,000,000バイト(UTF-8 raw)。EventBridgeの1MiB(1,048,576バイト)エントリキャップより小さく設定されており、source・detail-type・detailエンベロープのオーバーヘッド分を考慮済み。 |
| フォールバック動作 | 1,000,000バイト超のペイロードは従来通り:Classicは{"id":...}のみ、Eventsはpayload_url・payload_size_bytes・expires_atを含むスタブ送信。フォールバック処理コードは削除しないこと。 |
| ペイロード絞り込み | 大型リソースでも1MB超を避けたい場合はinclude_fields(Classic Webhook)またはEvents[events.subscription]のクエリセレクションで必要フィールドのみ取得するよう設計する。 |
| AWSターゲット確認 | EventBridgeに接続しているLambda・SQS・Kinesis等のターゲットが1MBのイベントを受け入れられるか確認が必要。受け入れ不可の場合はEventBridge Input Transformerで変換・絞り込みを実施する。 |
4対応チェックリスト
既存サブスクリプションの変更
設定ファイル・APIコールとも修正不要。自動適用されます。
フォールバック処理の維持{"id":...}・payload_url対応ロジックは1MB超ケースに引き続き必要です。
AWSダウンストリームの容量確認
Lambda・SQS等のターゲットが1MBイベントを処理できるか検証してください。
include_fieldsの活用
不要フィールドを除外してペイロードを1MB以内に収める設計も引き続き有効です。






Share:
Storefront API 2027-01:Market.metafieldsがケース非依存に
B2B顧客のロケーションアクセス権が変更