Пользовательские топики в службе Azure Event Grid

Раздел сетки событий предоставляет конечную точку, в которой источник отправляет события. Издатель создает тему для сетки событий и решает, требуется ли источнику событий одна тема или несколько тем. Используйте тему для коллекции связанных событий. Чтобы реагировать на события определенных типов, подписчикам следует решить, на какие из разделов подписаться.

Пользовательские темы — это темы приложений и сторонние темы. При создании или получении доступа к пользовательской теме вы увидите эту пользовательскую тему в подписке. Пользовательские темы поддерживают отправку. Обратитесь к разделу о том, когда использовать доставки pull или push, чтобы помочь вам понять, подходит ли push-доставка в соответствии с вашими требованиями.

При разработке приложения необходимо решить, сколько разделов нужно создать. Для относительно крупных решений создайте настраиваемый раздел для каждой категории связанных событий. Например, рассмотрим приложение, которое управляет учетными записями пользователей и другим приложением о заказах клиентов. Вряд ли все подписчики событий хотят событий из обоих приложений. Чтобы разделить проблемы, создайте два раздела: по одному для каждого приложения. Позвольте обработчикам событий подписаться на раздел в соответствии с их требованиями. Для небольших решений, возможно, целесообразнее отправлять все события в один раздел. Подписчики на события могут отфильтровать данные по требуемым типам событий.

Схема событий

Пользовательские топики поддерживают два типа схем событий: CloudEvents и схема Event Grid.

Схема CloudEvents

В дополнение к схеме событий по умолчанию, служба "Сетка событий Azure" поддерживает события в реализации JSON схемы CloudEvents версии 1.0 и привязку протокола HTTP. CloudEventsоткрытая спецификация для описания данных о событиях.

CloudEvents упрощает взаимодействие, предоставляя общую схему событий для публикации и использования событий. Эта схема позволяет использовать универсальные средства, стандартные способы маршрутизации и обработки событий, а также общий способ десериализации событий. Общая схема позволяет легко интегрировать работу на разных платформах.

Примечание.

Дополнительные сведения см. в статье о схеме событий облака.

Схема событий сети событий

При использовании схемы событий Сетки событий можно указать свойства конкретного приложения в объекте data.

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

Примечание.

Дополнительные сведения см. в статье о схеме событий Event Grid.

В следующих разделах приведены ссылки на руководства по созданию настраиваемых тем с помощью портала Azure, CLI, PowerShell и шаблонов Azure Resource Manager (ARM).

Учебники по порталу Azure

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

Заголовок Описание
Быстрый старт: создание и маршрутизация пользовательских событий с помощью портала Azure Показывает, как использовать портал для отправки пользовательских событий.
Быстрый старт: перенаправление пользовательских событий в хранилище очередей Azure В этой статье объясняется, как отправлять пользовательские события в хранилище очередей.
Как опубликовать в пользовательской теме Показывает, как опубликовать событие в пользовательской теме.

Учебники по Azure CLI

В следующих кратких инструкциях показано, как создать тему, отправить события в конечную точку темы и направить их в поддерживаемые назначения с помощью Azure CLI.

Заголовок Описание
Быстрое начало: создание и маршрутизация пользовательских событий с помощью Azure CLI Показывает, как использовать Azure CLI для отправки настраиваемых событий.
Azure CLI: создание пользовательской темы Event Grid Пример сценария, который создает пользовательскую тему. Скрипт извлекает конечную точку и ключ.
Создание подписки на события, связанные с пользовательским разделом, с использованием Azure CLI Пример сценария, который создает подписку на пользовательский раздел. Он отправляет события в веб-хук.

Учебники по Azure PowerShell

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

Заголовок Описание
Краткое руководство: создание и маршрутизация пользовательских событий с помощью Azure PowerShell Содержит сведения об отправке пользовательских событий с помощью Azure PowerShell.
PowerShell: создание пользовательской темы Event Grid Пример сценария, который создает пользовательскую тему. Этот скрипт извлекает конечную точку и ключ.
PowerShell: подписка на события для пользовательской темы Пример сценария, который создает подписку на пользовательский раздел. Он отправляет события в веб-хук.

Руководства по шаблонам ARM

В следующих кратких руководствах показано, как создать тему и подписку на нее с помощью шаблонов ARM.

Заголовок Описание
Шаблон Resource Manager: пользовательская тема и конечная точка WebHook Шаблон Resource Manager, который создает пользовательскую тему и подписку для этой пользовательской темы. Он отправляет события в веб-хук.
Шаблон Resource Manager: пользовательская тема и конечная точка для Event Hubs Шаблон Resource Manager, который создает подписку для обычной темы. Он отправляет события в Центры событий Azure.

Примечание.

Azure Digital Twins может маршрутизировать уведомления о событиях в пользовательские разделы, создаваемые с помощью службы "Сетка событий". Дополнительные сведения см. в статье "Конечные точки и маршруты событий" в документации по Azure Digital Twins.

См. следующие статьи: