サブスクリプション階層と削除ルール
サブスクリプションは、相互接続されたコンポーネントのシステムの一部です。この階層を理解すると、構成エラーの回避、依存関係の管理、安全に削除できるものの計画に役立ちます。
コンポーネント階層 [#component-hierarchy]
サブスクリプションは、2 つの独立したリソース プール (イベントと通知プロファイル) の間のバインディング層です。
- Events: チャネル レベルに存在する独立したイベントタイプ (
DELIVERY、INBOUND_MESSAGE、CLICKなど)。サブスクリプションは、リッスンする 1 つ以上のイベントを選択します。 - 通知プロファイル: Webhook URL とオプションの認証設定または証明書を使用した再利用可能な配信構成。サブスクリプションは 1 つのプロファイルのみを参照します。
- サブスクリプション: 各サブスクリプションは、選択したイベントを通知プロファイルにバインドし、通知をトリガーするイベントを絞り込むためのオプションのフィルターを使用します。複数のサブスクリプションは、同じイベントタイプを参照したり、同じ通知プロファイルを共有したりできます。
削除制約 [#deletion-constraints]
コンポーネントを削除できるのは、他に何も依存していない場合のみです。階層の最上位から下に削除する: 最初に依存関係 (サブスクリプション) を削除し、次に依存関係 (通知プロファイル、認証設定、証明書) を削除します。
| コンポーネント | 次の場合に削除可能 | ブロックされた場合 |
|---|---|---|
| サブスクリプション | いつも。サブスクリプションには依存関係がありません。 | ブロックされない |
| 通知プロファイル | どのサブスクリプションによっても参照されていない | まだ 1 つ以上のサブスクリプションにリンクされている |
| 認証設定 | どの通知プロファイルでも参照されていない | 1 つ以上のプロファイルにリンクされている |
| 証明書 | どの通知プロファイルにも割り当てられていません | まだ 1 つ以上のプロファイルに割り当てられている |
削除シーケンスの例 [#deletion-sequence]
すべてのコンポーネントを含むサブスクリプション設定を完全に削除するには、トップダウンで削除します。
サブスクリプションを削除する
通知プロファイル、認証設定、および証明書はそのまま残ります。このサブスクリプションにはリンクされなくなりましたが、他のユーザーが引き続き使用できます。
通知プロファイルを削除する
他のサブスクリプションが参照していない場合にのみ可能です。削除すると、認証設定と証明書のリンクが解除されます。
認証設定を削除する
他の通知プロファイルがそれらを参照していない場合にのみ可能です。
証明書を削除する
他の通知プロファイルが参照していない場合にのみ可能です。
コンポーネントの再利用パターン (共有設定と独立設定) については、サブスクリプション コンポーネント を参照してください。
ベストプラクティス [#best-practices]
コンポーネントの再利用を計画する
共有するコンポーネントを事前に決定します。これにより、構成のオーバーヘッドが削減され、継続的な管理が簡素化されます。
削除する前に依存関係を確認する
通知プロファイルを削除する前に、他のサブスクリプションが通知プロファイルに依存しているかどうかを確認してください。最初に別のプロファイルに再割り当てします。
トップダウンで削除
プロファイルの前のサブスクリプション、認証設定の前のプロファイル、および証明書の前の認証設定を削除します。
明確な名前を使用する
通知プロファイルと認証設定にわかりやすい名前を付けて、各コンポーネントが何をし、何がそれに依存するかを識別できるようにします。
Webhook サブスクリプションについて
コア概念とサブスクリプションのしくみ。
Webhook サブスクリプションの管理
サブスクリプションを作成、更新、削除します。
通知プロファイルの管理
Webhook URL と配信設定を構成します。
認証設定の管理
Webhook エンドポイントを Basic、HMAC、または OAuth で保護します。
証明書の管理
エンドポイント認証の相互 TLS を有効にします。