Webhook

Webhook は、着信通知をプログラマチックにコンシュームできるサービス宛先を表します。 たとえば、イベントに関する通知を受信すると、その通知の内容に基づいて、バックエンドのマイクロサービスへのWebhook宛先が動作を開始することがあります。

Webhook 宛先の構成

[ 送信先 ] タブで、Webhookの送信先を設定できます。 構成の一部として、Webhook URL と、Webhook の呼び出し時に呼び出される REST API 動詞を入力します。 宛先 Webhook に許可ヘッダーを入力することもできます。 サブスクリプションを作成して、Webhook 宛先をトピックに関連付けます。

対応 HTTP 動詞

Event Notifications webhookはhttp動詞のGET、POST、PUT、PATCHをサポートしています。

  • GET : 指定されたリソースの表現を取得する。
  • POST：新しいリソースを作成します。
  • PUT : リソース全体を提供されたデータで置き換える。
  • PATCH : リソースの部分的な変更を適用する。

Webhook 署名

着信通知が IBM Cloud Event Notifications からのものであることを識別するために、Webhook 署名を有効にすることができます。 署名が有効になっている場合、公開鍵をダウンロードし、それを使って受信した通知の内容を復号化することができます。

IPアドレスの一覧表示

IPアドレスの範囲を許可リストに登録することで、Webhookを受信するサーバーへのアクセスを制限することができます。 以下のIPアドレスがすべて許可リストに登録されていることを確認してください：

既存のWebhook IPアドレス

2026年9月末まで有効です。 WebhookのIPアドレス を確認してください。

新規 IP アドレス

2026年8月29日より施行：

  • グローバル共通のIPアドレス ： マルチゾーン地域については、「個別のIPアドレス 」を参照してください。

  • 地域固有のIPアドレス ： Event Notifications サービスインスタンスがデプロイされている地域のIPアドレスを許可リストに登録します。 複数のリージョンで Event Notifications のサービスインスタンスを使用する場合は、該当する各リージョンのIPアドレスを許可リストに登録してください。

ダラス (us-south)

  • パブリック
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- プライベート

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

シドニー (au-syd)

  • パブリック
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- プライベート

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

ロンドン (eu-gb)

  • パブリック
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- プライベート

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

マドリード (eu-es)

  • パブリック
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- プライベート

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

フランクフルト (eu-de)

  • パブリック
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- プライベート

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

大阪 (jp-osa)

  • パブリック
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- プライベート

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

東京 (jp-tok)

  • パブリック
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- プライベート

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

トロント (ca-tor)

  • パブリック
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- プライベート

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

モントリオール（ca-mon）

  • パブリック
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- プライベート

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

サンパウロ (br-sao)

  • パブリック
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- プライベート

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

ワシントン DC (us-east)

  • パブリック
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- プライベート

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

チェンナイ(in-che)

  • パブリック
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- プライベート

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

ムンバイ（イン・マム）

  • パブリック
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- プライベート

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

Webhook 再試行ポリシー

Webhookを呼び出す際、ネットワークエラーやアプリケーションの不具合などの問題により、リクエストが失敗することがあります。 Event Notifications、失敗したリクエストは自動的に再試行され、外部からのリクエストに対する回復力を提供します。

再試行回数、遅延、タイムアウト値などの再試行動作の詳細については、 宛先の再試行ポリシーを 参照してください。

ウェブフック送信先設定のテスト

オプションメニューで、Webhookの送信先をテストすることができます。 ワンクリックで、指定した宛先に対して、設定内容が正しいかどうかを確認することができます。

デスティネーションのテストの詳細については、「 デスティネーションのテスト 」を参照してください。