Доставка данных с помощью HTTP

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

Внимание

Этот документ помогает приступить к работе с возможностями сетки событий, которые используют протокол HTTP. Эта статья подходит для пользователей, которым требуется интегрировать приложения в облако. Если вам нужно общаться с данными устройства Интернета вещей, ознакомьтесь с общими сведениями о поддержке MQTT в Сетке событий Azure.

Основные понятия

CloudEvents

Сетка событий соответствует открытой спецификации CloudEvents 1.0 с помощью привязки протокола HTTP с форматом JSON. Это соответствие означает, что решения публикуют и используют сообщения о событиях, используя следующий формат:

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

Что такое событие?

Событие — это наименьший объем информации, который полностью описывает то, что произошло в системе. Событие часто называется дискретным событием, так как оно представляет собой отдельный, автономный факт о системе, который предоставляет полезную информацию, которую можно использовать для принятия решений. Примеры: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Примечание.

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

Для получения дополнительной информации о событиях см. раздел Терминология Event Grid.

Другой вид события

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

Разделы и подписки на события

События, опубликованные в Event Grid, поступают в тему, которая является ресурсом, логически содержащим все события. Подписка на события — это ресурс конфигурации, связанный с одним разделом. Помимо прочего, используйте подписку на события, чтобы задать критерии выбора событий, чтобы определить коллекцию событий, доступную подписчику из общего набора событий, присутствующих в разделе.

Схема, показывающая раздел и связанные подписки на события.

Пуш-уведомление

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

  • Системные разделы. Используйте системные разделы для получения (системных) событий из служб Azure.
  • Пользовательские темы. Используйте настраиваемые разделы, когда вы хотите опубликовать события приложения.
  • Домены. Домены представляют группу разделов домена, которые обычно связаны с одним приложением, которое требует отправки событий различным группам пользователей, организаций или приложений. Распространенный подход заключается в связывании раздела домена с группой целевых приложений или пользователей организации в одном клиенте. Организация может быть командой, подразделением компании, компанией и т. д.
  • Темы партнеров Используйте разделы партнеров, когда вы хотите использовать события от сторонних партнеров.

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

На следующей схеме показаны ресурсы, которые поддерживают push-рассылку с помощью некоторых из поддерживаемых обработчиков событий.

Схема высокого уровня, показывающая все типы разделов, которые поддерживают отправку push-уведомлений, а именно системные, пользовательские, доменные и партнерские разделы.

Примечание.

Дополнительные сведения о доставке push-сообщений в пространствах имен Event Grid см. в разделе [namespace-push-delivery-overview.md].

Следующие шаги

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