配信不能な場所の設定と再試行ポリシー

イベント サブスクリプションの作成時には、イベント配信の設定をカスタマイズできます。 この記事では、配信不能の場所の設定方法と、再試行の設定のカスタマイズ方法を示します。 これらの機能については、「Event Grid によるメッセージの配信と再試行」をご覧ください。

配信不能の場所の設定

配信不能の場所を設定するには、エンドポイントに配信できなかったイベントを保持するためストレージ アカウントが必要です。 この例では、既存のストレージ アカウントのリソース ID を取得します。 ここでは、配信不能エンドポイント用にそのストレージ アカウント内のコンテナーを使用するイベント サブスクリプションを作成します。

Azure portal

イベント サブスクリプションの作成時に、次の図に示すように、[追加機能] タブで配信不能を有効にできます。 この機能を有効にした後、配信不能イベントを保持する BLOB コンテナーと、BLOB ストレージを持つ Azure サブスクリプションを指定します。

必要に応じて、配信不能に対するシステム割り当てマネージド ID またはユーザー割り当てマネージド ID を有効にできます。 マネージド ID は、ストレージへのイベントの書き込みを許可する「ロールベースのアクセス制御 (RBAC) ロール」のメンバーである必要があります。

配信不能を有効にして、既存のイベント サブスクリプション設定の構成もできます。 イベント サブスクリプションの [イベント サブスクリプション] ページで、[追加機能] タブに切り替えて、次の図に示すように配信不能設定を表示します。

Azure CLI

containername=testcontainer

topicid=$(az eventgrid topic show --name demoTopic -g gridResourceGroup --query id --output tsv)
storageid=$(az storage account show --name demoStorage --resource-group gridResourceGroup --query id --output tsv)

az eventgrid event-subscription create \
  --source-resource-id $topicid \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --deadletter-endpoint $storageid/blobServices/default/containers/$containername

配信不能処理を無効にするには、コマンドを再実行してイベント サブスクリプションを作成しますが、deadletter-endpoint の値は指定しないでください。 イベント サブスクリプションを削除する必要はありません。

PowerShell

$containername = "testcontainer"

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id
$storageid = (Get-AzStorageAccount -ResourceGroupName gridResourceGroup -Name demostorage).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -DeadLetterEndpoint "$storageid/blobServices/default/containers/$containername"

配信不能処理を無効にするには、コマンドを再実行してイベント サブスクリプションを作成しますが、DeadLetterEndpoint の値は指定しないでください。 イベント サブスクリプションを削除する必要はありません。

再試行ポリシーの設定

Event Grid サブスクリプションの作成時には、Event Grid がイベント配信を試行する期間の値を設定できます。 既定では、Event Grid は、24 時間 (1440 分)、または 30 回の試行を行います。 Event Grid サブスクリプションには、これらの値のいずれかを設定できます。 イベントの有効期限の値は 1 から 1440 までの整数にする必要があります。 最大再試行回数は 1 から 30 までの整数にする必要があります。

再試行のスケジュールを構成することはできません。

Azure portal

イベント サブスクリプションの作成時に、[追加機能] タブで再試行ポリシー設定を構成できます。

既存のイベント サブスクリプションの再試行ポリシー設定の構成もできます。 イベント サブスクリプションの [イベント サブスクリプション] ページで、[追加機能] タブに切り替えて、次の図に示すように再試行ポリシー設定を表示します。

Azure CLI

イベントの Time to Live を 1440 分以外の値に設定するには、次のコマンドを使用します。

az eventgrid event-subscription create \
  -g gridResourceGroup \
  --topic-name <topic_name> \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --event-ttl 720

最大再試行回数を 30 以外の値に設定するには、次のコマンドを使用します。

az eventgrid event-subscription create \
  -g gridResourceGroup \
  --topic-name <topic_name> \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --max-delivery-attempts 18

PowerShell

イベントの Time to Live を 1440 分以外の値に設定するには、次のコマンドを使用します。

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -EventTtl 720

最大再試行回数を 30 以外の値に設定するには、次のコマンドを使用します。

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -MaxDeliveryAttempt 18

次のステップ

• Azure 関数アプリを利用して配信不能イベントを処理するサンプル アプリケーションについては、「Azure Event Grid Dead Letter Samples for .NET」 (.NET 向け Azure Event Grid 配信不能サンプル) を参照してください。
• イベント配信と再試行については、「Event Grid によるメッセージ配信と再試行」をご覧ください。
• Event Grid の概要については、Event Grid の紹介に関する記事を参照してください。
• Event Grid の使用をすぐに開始するには、Azure Event Grid でのカスタム イベントの作成とルーティングに関する記事を参照してください。