Отправка отправки с помощью HTTP

  • Статья

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

Важно!

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

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

Источники облачных

Сетка событий соответствует открытой спецификации CloudEvents 1.0 CNCF с использованием привязки протокола 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 или просто события , чтобы ссылаться на эти сообщения, которые сообщают об изменении состояния системы.

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

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

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

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

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

Diagram showing a topic and associated event subscriptions.

Отправка отправки

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

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

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

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

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Примечание.

Если вы хотите узнать больше о принудительной доставке в пространствах имен Сетки событий, см. статью [namespace-push-delivery-overview.md].

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

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