Azure Event Gridでカスタム トピックまたはドメインを作成する

Event Gridのカスタムトピックは、ユーザー定義のエンドポイントを提供し、自分のアプリケーションイベントを公開できます。 ドメインは関連トピックを一つのリソースとして管理できるため、大規模な組織内の多くの購読者にイベントを送信する際に役立ちます。

この記事では、Azureポータルを使ってAzure Event Gridでカスタムトピックやドメインを作成する方法を紹介します。

前提条件

Azure Event Gridが初めての方は、始める前にEvent Gridの概要を必ず読んでください。

Event Grid リソース プロバイダーを登録する

以前に Event Grid を使用していない限り、Event Grid リソース プロバイダーを登録する必要があります。 前に Event Grid を使用した場合は、次のセクションに進んでください。

Azure portal で次の手順を実行します。

1. 左側のメニューで [サブスクリプション] を選択します。

2. サブスクリプションの一覧から Event Grid に使用するサブスクリプションを選択します。

3. [ サブスクリプション ] ページの左側のメニューの [設定] で、[ リソース プロバイダー] を選択します。

4. Microsoft.EventGrid を検索し、状態が NotRegistered であることを確認します。

5. プロバイダーの一覧で [Microsoft.EventGrid] を選択します。

6. コマンド バーで[ 登録]を選択します。

   

7. 更新して、Microsoft.EventGrid の状態が Registered に変わっていることを確認します。

   

カスタム トピックまたはドメインを作成する

Event Grid のトピックは、イベントの送信先となるユーザー定義のエンドポイントになります。

1. Azure portal にサインインする

2. 上部の検索バーに「 Event Grid トピック」と入力し、ドロップダウン リストから [Event Grid トピック ] を選択します。 ドメインを作成するには、 Event Grid ドメインを検索します。

   

3. [ Event Grid トピック ] または [ Event Grid ドメイン] ページで 、ツール バーの [ + 作成 ] を選択します。

   

基本ページ

トピック作成またはイベントグリッドドメイン作成ウィザードの基本ページでは、以下の手順に従ってください:

1. Azure サブスクリプションを選択します。

2. 既存のリソース グループを選択するか、 [新規作成] を選択し、リソース グループの名前を入力します。

3. カスタムトピックやドメインに固有の 名前 を入力してください。 ドメインネームシステム(DNS)のエントリがその名前を表すため、名前は一意でなければなりません。 画像に示されている名前は使用しないでください。 独自の名前を作成してください。 3文字から50文字の間で、a-z、A-Z、0-9、「-」のみの値のみを含みます。

4. Event Grid トピックまたはドメインの 場所 を選択します。

5. [ 次へ: ネットワーク ] ページに切り替えるには、ページの下部にある [ネットワーク ] を選択します。

   

ネットワーク ページ

トピックの作成または Event Grid ドメインの作成ウィザードの [ネットワーク] ページで、次の手順に従います。

1. クライアントがパブリック IP アドレスを介してトピックまたはドメイン エンドポイントに接続できるようにする場合は、[ パブリック アクセス ] オプションをオンのままにします。 特定のIPアドレスやIPアドレス範囲へのアクセスを制限できます。

   

2. プライベート エンドポイント経由でトピックまたはドメインへのアクセスを許可するには、[ プライベート アクセス ] オプションを選択します。

   

3. 「Azureポータルを使ってプライベートエンドポイントを追加する」セクションの指示に従ってプライベートエンドポイントを作成します。

4. [次へ: セキュリティ] ページに切り替えるには、ページの下部にある [セキュリティ] を選択します。

[セキュリティ] ページ

トピックの作成または Event Grid ドメインの作成ウィザードの [セキュリティ] ページで、次の手順に従います。

1. システム割り当てマネージド ID をトピックまたはドメインに割り当てるには、[ システム割り当て ID を有効にする] を選択します。

   

2. ユーザー割り当て ID を割り当てるには、ページの [ ユーザー割り当て ID ] セクションで [ ユーザー割り当て ID の 追加] を選択します。

3. 「 ユーザー割り当てアイデンティティを選択する 」ウィンドウで、そのユーザー割り当てアイデンティティを持つサブスクリプションを選択し、 ユーザー割り当てアイデンティティを選択し、「 セレクト」を選択します。

   

4. ローカル認証を無効にするには、[ 無効] を選択します。 ローカル認証を無効にすると、トピックやドメインはMicrosoft Entra認証のみを受け入れ、アクセスキーやSAS認証は認めません。

   

5. 最低限必要なトランスポート層セキュリティ (TLS) バージョンを構成します。 詳細については、「 最小 TLS バージョンの構成」を参照してください。

   

6. ページの下部にある [ 詳細設定 ] を選択して、[ 詳細設定 ] ページに切り替えます。

[詳細設定] ページ

1. トピック作成またはイベントグリッドドメイン作成ウィザードのアドバンスページで、このトピックに公開するイベントのスキーマを選択します。

   

2. データレジデンシーでは、すべてのデータを同じリージョンに保持するか(リージョナル)、またはメタデータをあらかじめ定義された二次リージョンに複製するか(クロスジオ版)を選択します。

   

   Cross-Geo オプションを使用すると、リージョン障害が発生した場合に、Microsoft 主導でペアになっているリージョンへのフェールオーバーを実行できます。 詳細については、「Azure Event Gridでのサーバー側 geo ディザスター リカバリー」を参照してください。 Microsoftは稀な状況でMicrosoft主導のフェイルオーバーを実施し、影響を受けた地域から対応するジオペアリージョンへのイベントグリッドリソースのフェイルオーバーを行います。 このプロセスはあなたの介入を必要としません。 Microsoftはこの道を進むかどうかを決定する権利を留保します。 このメカニズムは、トピックまたはドメインをフェイルオーバーする前に、あなたの同意を必要としません。 詳細は「 フェイルオーバーからの回復方法」をご覧ください。

   [地域] オプションを選択した場合は、独自のディザスター リカバリー計画を定義できます。

3. [次へ: タグ] を選択して、[タグ] ページに移動します。

タグページ

タグページにはイベントグリッド専用のフィールドはありません。 他のAzure リソースの場合と同様に、タグ (名前と値のペア) を割り当てることができます。 [ 次へ: 確認と作成 ] を選択して、[ 確認と作成 ] ページに切り替えます。

[確認および作成] ページ

[ 確認と作成 ] ページで、すべての設定を確認し、検証が成功したことを確認し、[ 作成 ] を選択してトピックまたはドメインを作成します。

次のステップ

カスタム トピックまたはドメインを作成する方法を理解したら、Event Grid でできることの詳細を確認してください。

• Azure ポータルと Event Grid を使用してカスタム イベントを Web エンドポイントにルーティングする
• Event Grid について
• イベント ハンドラー

異なるプログラミング言語を用いてイベントを公開し、イベントを消費する方法については、以下のサンプルをご覧ください。

• .NET 用の Azure Event Grid サンプル
• Java 用の Azure Event Grid サンプル
• Python 用の Azure Event Grid サンプル
• JavaScript 用の Azure Event Grid サンプル
• TypeScript 用の Azure Event Grid サンプル