Logo
Logo
CTRLK

関連情報

サブスクリプション階層と削除ルール


サブスクリプションは、相互接続されたコンポーネントのシステムの一部です。この階層を理解すると、構成エラーの回避、依存関係の管理、安全に削除できるものの計画に役立ちます。



コンポーネント階層 [#component-hierarchy]


Diagram showing subscriptions as a binding layer between an events pool on the left and a notification profiles pool on the right, with color-coded arrows showing how each subscription selects events and references a notification profile

サブスクリプションは、2 つの独立したリソース プール (イベントと通知プロファイル) の間のバインディング層です。

  • Events: チャネル レベルに存在する独立したイベントタイプ (DELIVERYINBOUND_MESSAGECLICK など)。サブスクリプションは、リッスンする 1 つ以上のイベントを選択します。
  • 通知プロファイル: Webhook URL とオプションの認証設定または証明書を使用した再利用可能な配信構成。サブスクリプションは 1 つのプロファイルのみを参照します。
  • サブスクリプション: 各サブスクリプションは、選択したイベントを通知プロファイルにバインドし、通知をトリガーするイベントを絞り込むためのオプションのフィルターを使用します。複数のサブスクリプションは、同じイベントタイプを参照したり、同じ通知プロファイルを共有したりできます。


削除制約 [#deletion-constraints]

コンポーネントを削除できるのは、他に何も依存していない場合のみです。階層の最上位から下に削除する: 最初に依存関係 (サブスクリプション) を削除し、次に依存関係 (通知プロファイル、認証設定、証明書) を削除します。


コンポーネント次の場合に削除可能ブロックされた場合
サブスクリプションいつも。サブスクリプションには依存関係がありません。ブロックされない
通知プロファイルどのサブスクリプションによっても参照されていないまだ 1 つ以上のサブスクリプションにリンクされている
認証設定どの通知プロファイルでも参照されていない1 つ以上のプロファイルにリンクされている
証明書どの通知プロファイルにも割り当てられていませんまだ 1 つ以上のプロファイルに割り当てられている

削除シーケンスの例 [#deletion-sequence]

すべてのコンポーネントを含むサブスクリプション設定を完全に削除するには、トップダウンで削除します。


1

サブスクリプションを削除する
通知プロファイル、認証設定、および証明書はそのまま残ります。このサブスクリプションにはリンクされなくなりましたが、他のユーザーが引き続き使用できます。

2

通知プロファイルを削除する
他のサブスクリプションが参照していない場合にのみ可能です。削除すると、認証設定と証明書のリンクが解除されます。

3

認証設定を削除する
他の通知プロファイルがそれらを参照していない場合にのみ可能です。

4

証明書を削除する
他の通知プロファイルが参照していない場合にのみ可能です。



コンポーネントの再利用パターン (共有設定と独立設定) については、サブスクリプション コンポーネント を参照してください。


ベストプラクティス [#best-practices]

Plan component reuse

コンポーネントの再利用を計画する

共有するコンポーネントを事前に決定します。これにより、構成のオーバーヘッドが削減され、継続的な管理が簡素化されます。

Review dependencies

削除する前に依存関係を確認する

通知プロファイルを削除する前に、他のサブスクリプションが通知プロファイルに依存しているかどうかを確認してください。最初に別のプロファイルに再割り当てします。

Delete top-down

トップダウンで削除

プロファイルの前のサブスクリプション、認証設定の前のプロファイル、および証明書の前の認証設定を削除します。

Use clear naming

明確な名前を使用する

通知プロファイルと認証設定にわかりやすい名前を付けて、各コンポーネントが何をし、何がそれに依存するかを識別できるようにします。



関連ページ

Webhook サブスクリプションについて
コア概念とサブスクリプションのしくみ。

Webhook サブスクリプションの管理
サブスクリプションを作成、更新、削除します。

通知プロファイルの管理
Webhook URL と配信設定を構成します。

認証設定の管理
Webhook エンドポイントを Basic、HMAC、または OAuth で保護します。

証明書の管理
エンドポイント認証の相互 TLS を有効にします。