Задание расположения для недоставленных сообщений и политики повтора

При создании подписки на события, можно настроить параметры доставки событий. В этой статье показано, как настроить расположение недоставленных сообщений и параметры повторных попыток. Сведения об этих возможностях см. в разделе Доставка и повторные попытки доставки сообщений сетки событий.

Установка размещения недоставленных сообщений

Чтобы задать расположение недоставленных сообщений, потребуется учетная запись хранения для хранения событий, которые невозможно доставить в конечную точку. В этом примере возвращается идентификатор ресурса существующей учетной записи хранения. Также создается подписка на событие, которая использует контейнер в этой учетной записи хранения для недоставленных сообщений конечной точки.

Портал Azure

При создании подписки на события можно включить недоставку на вкладке "Дополнительные функции ", как показано на следующем рисунке. После включения функции укажите контейнер BLOB-объектов, в котором будут храниться события недоставленной буквы и подписка Azure с хранилищем BLOB-объектов.

При необходимости можно включить управляемое удостоверение, назначаемое системой или назначаемое пользователем, для недоставленных букв. Управляемое удостоверение должно быть членом роли управления доступом на основе ролей (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. Удалять подписку на события не нужно.

Установка политики повтора

При создании подписки на сетку событий, можно задать значения для продолжительности попыток доставки события службой "Сетка событий Azure". По умолчанию служба "Сетка событий Azure" осуществляет не более 30 попыток в течение 24 часов (1440 минут). Вы можете задать любое из этих значений для подписки сетки событий. Значение для срока жизни события должно представлять собой целое число от 1 до 1440. Максимальное значение для попыток должно представлять собой целое число от 1 до 30.

Настроить интервал повтора невозможно.

Портал Azure

При создании подписки на событие можно настроить параметры политики повторных попыток на вкладке "Дополнительные функции ".

Можно также настроить параметры политики повторных попыток для существующей подписки на события. На странице подписки на события перейдите на вкладку "Дополнительные функции", чтобы просмотреть параметры политики повторных попыток, как показано на следующем рисунке.

Azure CLI

Чтобы установить время жизни события на значение, отличное от 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

Чтобы установить время жизни события на значение, отличное от 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 для .NET.
• См. дополнительные сведения о доставке сообщений и повторных попытках в Сетке событий.
• Общие сведения о службе "Сетка событий" см. в разделе Общие сведения о службе "Сетка событий Azure".
• Сведения о том, как быстро приступить к использованию службы "Сетка событий", см. в разделе Создание и перенаправление пользовательского события со службой "Сетка событий Azure".