Azure Event Grid でのカスタム トピック

Event Grid のトピックには、ソースがイベントを送信するエンドポイントが含まれます。 発行元は、イベント グリッド トピックを作成し、イベント ソースにトピックが 1 つ必要か、あるいは複数のトピックが必要かを決定します。 トピックは、関連するイベントのコレクションに使用されます。 サブスクライバーは、特定の種類のイベントに応答するために、どのトピックをサブスクライブするかを決定します。

カスタム トピックは、アプリケーションとサード パーティのトピックです。 カスタムのトピックを作成した、またはカスタムのトピックへのアクセスを許可された場合は、サブスクリプション内にそのカスタム トピックが表示されます。 カスタム トピックでは、プッシュ配信がサポートされています。 プルまたはプッシュ配信を使用するタイミングを調査すると、要件に応じてプッシュ配信が適切なアプローチかどうかを判断するのに役立ちます。

アプリケーションを設計するときに、作成するトピック数を決定する必要があります。 比較的大規模なソリューションの場合、関連するイベントのカテゴリごとにカスタム トピックを作成します。 たとえば、ユーザー アカウントを管理するアプリケーションと、顧客の注文に関する別のアプリケーションを考えてみましょう。 すべてのイベント サブスクライバーが両方のアプリケーションのイベントを必要とする可能性は低いです。 懸念事項を分離するには、2 つのトピックを作成します。これは、アプリケーションごとに 1 つずつです。 イベント ハンドラーが要件に従ってトピックをサブスクライブできるようにします。 小規模なソリューションの場合、すべてのイベントを 1 つのトピックに送信することをお勧めします。 イベントのサブスクライバーは、必要なイベントの種類をフィルター処理できます。

イベント スキーマ

カスタム トピックでは、Cloud Events と Event Grid スキーマの 2 種類のイベント スキーマがサポートされています。

クラウド イベント スキーマ

Azure Event Grid は、既定のイベント スキーマに加え、CloudEvents v1.0 および HTTP プロトコル バインディングの JSON 実装のイベントをネイティブでサポートします。 CloudEvents は、イベント データを記述するためのオープンな仕様です。

CloudEvents を使用すると、イベントを発行したり使用したりするための共通のイベント スキーマを提供して、相互運用性を簡略化することができます。 このスキーマを使用すると、統一されたツール、イベントのルーティングと処理の標準的な方法、およびイベントを逆シリアル化する一般的な方法が可能になります。 共通のスキーマを使用することで、プラットフォーム間での作業をより簡単に統合できます。

Event Grid イベント スキーマ

Event Grid イベント スキーマを使用する場合は、データ オブジェクトでアプリケーション固有のプロパティを指定できます。

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

以下のセクションでは、Azure portal、CLI、PowerShell、および Azure Resource Manager (ARM) テンプレートを使用してカスタム トピックを作成するためのチュートリアルへのリンクを示します。

Azure portal のチュートリアル

Azure CLI のチュートリアル

Azure PowerShell のチュートリアル

ARM テンプレートのチュートリアル

次のステップ

次の記事をご覧ください。

• システム トピック
• ドメイン