Definir a localização e a política de repetição das mensagens não entregues

Ao criar uma subscrição de evento, pode personalizar as definições para entrega de eventos. Este artigo mostra-lhe como configurar uma localização de letra não entregue e personalizar as definições de repetição. Para obter informações sobre estas funcionalidades, veja Entrega e repetição de mensagens do Event Grid.

Definir a localização da letra não entregue

Para definir uma localização de letra não entregue, precisa de uma conta de armazenamento para realizar eventos que não podem ser entregues num ponto final. Os exemplos obtêm o ID de recurso de uma conta de armazenamento existente. Criam uma subscrição de evento que utiliza um contentor nessa conta de armazenamento para o ponto final de letra não entregue.

Portal do Azure

Ao criar uma subscrição de evento, pode ativar as letras não entregues no separador Funcionalidades adicionais , conforme mostrado na imagem seguinte. Depois de ativar a funcionalidade, especifique o contentor de blobs que irá conter eventos sem letras e a subscrição do Azure que tem o armazenamento de blobs.

Opcionalmente, pode ativar uma identidade gerida atribuída pelo sistema ou atribuída pelo utilizador para letras não entregues. A identidade gerida tem de ser membro de uma função de controlo de acesso baseado em funções (RBAC) que permita escrever eventos no armazenamento.

Também pode ativar as letras não entregues e configurar as definições de uma subscrição de evento existente. Na página Subscrição de Eventos da sua subscrição de eventos, mude para o separador Funcionalidades adicionais para ver as definições de letra não entregue, conforme mostrado na imagem seguinte.

CLI do Azure

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

Para desativar as letras não entregues, execute novamente o comando para criar a subscrição do evento, mas não forneça um valor para deadletter-endpoint. Não precisa de eliminar a subscrição do evento.

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"

Para desativar as letras não entregues, execute novamente o comando para criar a subscrição do evento, mas não forneça um valor para DeadLetterEndpoint. Não precisa de eliminar a subscrição do evento.

Definir política de repetição

Ao criar uma subscrição do Event Grid, pode definir valores durante quanto tempo o Event Grid deve tentar entregar o evento. Por predefinição, o Event Grid tenta durante 24 horas (1440 minutos) ou 30 vezes. Pode definir qualquer um destes valores para a sua subscrição do Event Grid. O valor do evento time-to-live tem de ser um número inteiro de 1 a 1440. O valor das repetições máximas tem de ser um número inteiro de 1 a 30.

Não pode configurar a agenda de repetição.

Portal do Azure

Ao criar uma subscrição de evento, pode configurar as definições de política de repetição no separador Funcionalidades adicionais .

Também pode configurar as definições de política de repetição para uma subscrição de evento existente. Na página Subscrição de Eventos da sua subscrição de eventos, mude para o separador Funcionalidades adicionais para ver as definições da política de repetição, conforme mostrado na imagem seguinte.

CLI do Azure

Para definir o tempo de vida do evento para um valor diferente de 1440 minutos, utilize:

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

Para definir as repetições máximas para um valor diferente de 30, utilize:

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

PowerShell

Para definir o tempo de vida do evento para um valor diferente de 1440 minutos, utilize:

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

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

Para definir as repetições máximas para um valor diferente de 30, utilize:

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

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

Passos seguintes

• Para obter um exemplo de aplicação que utiliza uma aplicação de Funções do Azure para processar eventos de letra não entregue, veja Azure Event Grid Exemplos de Letra Morta para .NET.
• Para obter informações sobre a entrega e repetições de eventos, entrega e repetição de mensagens do Event Grid.
• Para obter uma introdução ao Event Grid, veja Sobre o Azure Event Grid.
• Para começar rapidamente a utilizar o Event Grid, veja Criar e encaminhar eventos personalizados com Azure Event Grid.