次の方法で共有


HTTP によるプッシュ配信

この記事は、「Azure Event Grid とは」の記事に基づいており、HTTP 経由で Event Grid のプルおよびプッシュ配信の使用を開始する前に重要な情報を提供します。 基本的な概念、リソース モデル、メッセージ配信モードについて説明します。 このドキュメントの最後には、Event Grid の使用方法を示す記事や、詳細な概念情報を提供する記事への便利なリンクが記載されています。

重要

このドキュメントは、HTTP プロトコルを使用する Event Grid 機能の使用を開始するのに役立ちます。 この記事は、クラウド上のアプリケーションを統合する必要があるユーザーに適しています。 IoT デバイス データを通信する必要がある場合は、 Azure Event Grid での MQTT サポートの概要に関するページを参照してください。

主要な概念

CloudEvents

Event Grid は、JSON 形式HTTP プロトコル バインドを使用して、Cloud Native Computing Foundation (CNCF) のオープン標準 CloudEvents 1.0 仕様に準拠しています。 この準拠は、次の例のような形式を使用して、ソリューションがイベント メッセージを発行して使用することを意味します。

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

イベントとは

イベントは、システム内で発生した何かを詳細に記述する最小限の情報です。 イベントは、アクション可能な分析情報を提供するシステムに関する独立した独立した事実を表しているため、多くの場合、個別のイベントと呼ばれます。 例: com.yourcompany.Orders.OrderCreatedorg.yourorg.GeneralLedger.AccountChangedio.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached

注意

個別のイベントクラウド イベント、または単なるイベントという用語を同じ意味で使用して、システム状態の変化について通知するメッセージを表します。

イベントの詳細については、Event Grid の用語を参照してください。

別の種類のイベント

また、ユーザー コミュニティは、デバイスからの 1 回の読み取りや Web アプリケーション ページでのシングル クリックなど、データ ポイントを運ぶメッセージの種類としてイベントを参照します。 このようなイベントは、通常、分析情報を導き出してアクションを実行するために、所定の時間枠またはイベント ストリーム サイズで分析されます。 Event Grid のドキュメントでは、そのようなイベントは データ ポイントストリーミング データ、または テレメトリと呼ばれます。 これは、Event Grid のメッセージ キュー テレメトリ トランスポート (MQTT) でサポートされ、Azure Event Hubs が通常処理するデータの一種です。

トピックとイベント サブスクリプション

Event Grid に対して発行されたイベントは、トピックに配置されます。これは、論理的にすべてのイベントを格納するリソースです。 イベント サブスクリプションは、1 つのトピックに関連付けられた構成リソースです。 特に、イベント サブスクリプションを使用してイベント選択条件を設定し、トピックに存在するイベントの合計セットからサブスクライバーが使用できるイベント コレクションを定義します。

トピックと関連付けられたイベント サブスクリプションを表す図。

プッシュ配信

次のリソースは、プッシュ配信をサポートしています。 各リソースの詳細については、リンクを選択してください。

  • システム トピック。 システム トピックは、Azure サービスから (システム) イベントを受信するために使用します。
  • カスタム トピック。 カスタム トピックは、アプリケーションのイベントを発行するときに使用します。
  • ドメイン。 ドメインは、通常、ユーザー、組織、またはアプリケーションの異なるグループにイベントを送信する必要がある単一のアプリケーションに関連付けられているドメイン トピックのグループを表します。 一般的な方法は、ドメイン トピックをターゲット アプリケーションのグループまたは同じテナント内の組織のユーザーに関連付けることです。 組織は、チーム、社内の部門、会社などです。
  • パートナー トピック。 パートナー トピックは、サード パーティのパートナーからのイベントを消費するときに使用します。

イベントのフィルター条件を指定し、サポートされているイベント ハンドラーのいずれかに宛先を設定するように、システム、カスタム、またはパートナーのトピックのイベント サブスクリプションを構成します。

サポートされているいくつかのイベント ハンドラーでプッシュ配信をサポートするリソースを、次の図に示します。

プッシュ配信をサポートするすべてのトピックの種類、つまりシステム、カスタム、ドメイン、およびパートナーの各トピックを示す概要図。

注意

Event Grid 名前空間でのプッシュ配信の詳細については、「[namespace-push-delivery-overview.md]」を参照してください。

次のステップ

次の記事では、Event Grid の使用方法に関する情報を提供するか、概念に関する追加情報を提供します。