Отправка сообщений в служебную шину Azure из службы "Управление API Azure"

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Стандартный | Премия

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

Служебная шина Azure — это полностью управляемая корпоративная служба обмена сообщениями, предназначенная для разделения приложений и служб, обеспечивая надежное облачное обмен сообщениями между распределенными системами. Она поддерживает AMQP (расширенный протокол очереди сообщений) для систем отправки сообщений в очередь сообщений для персональной передачи сообщений и в темы для моделей публикации и подписки. Служебная шина идеально подходит для сценариев, требующих асинхронных операций, выравнивания нагрузки или интеграции в гибридных облачных средах. Дополнительные сведения см. в документации по служебной шине Azure.

Интеграция на основе политик обеспечивает управление API:

• Защита обмена сообщениями на основе REST для внешних клиентов — внешние системы и мобильные приложения, которые не имеют собственной поддержки AMQP, могут отправлять сообщения в служебную шину с помощью стандартных API-интерфейсов HTTP/REST API через управление API. Этот подход упрощает интеграцию и повышает безопасность, устраняя потребность в пользовательских посредниках.
• Управляемые сторонние интеграции . Предприятия могут предоставлять конечные точки служебной шины через управление API с встроенной проверкой подлинности управляемого удостоверения, обеспечивая безопасные и наблюдаемые шаблоны обмена сообщениями для партнеров и сторонних приложений.
• Модель 'стрельнул и забыл'. Для отправки сообщений в Service Bus не требуются другие серверные службы, что позволяет упростить архитектуру и сократить эксплуатационные расходы.

Замечание

• Интеграция управления API с служебной шиной в настоящее время находится в предварительной версии.
• Поддерживается только отправка сообщений на Service Bus.

Замечание

В настоящее время эта функция недоступна в рабочих областях.

Предпосылки

• Экземпляр службы управления API. Если у вас его нет, см. статью "Создание экземпляра службы управления API".

• API управления интерфейсами программирования, используемый для отправки сообщений в сервисную шину.

• Очередь или тема в пространстве имен служебной шины Azure для получения сообщений. Подробные инструкции см. в следующем разделе:

  • Создание пространства имен и очереди служебная шина
  • Создайте тему и подписки к теме в сервисной шине

  Замечание

  • Если вы хотите использовать топики и подписки, выберите уровень "Standard" или "Premium" Service Bus.
  • Ресурс служебной шины может находиться в другой подписке или даже в другом клиенте, отличном от ресурса управления API.

• Разрешения для назначения ролей управляемому удостоверению.

Настройка доступа к служебной шине

Чтобы отправить сообщения в служебную шину, необходимо настроить управляемое удостоверение для экземпляра службы управления API:

1. Включите управляемое удостоверение, назначаемое системой или назначаемое пользователем , для управления API в экземпляре управления API.

   • Если вы включите управляемое удостоверение, назначенное пользователем, запишите идентификатор клиента этого удостоверения.

2. Назначьте удостоверение роли отправителя данных шины обслуживания Azure, в пределах шины обслуживания. Чтобы назначить роль, используйте портал Azure или другие средства Azure.

Настройка политики send-service-bus-message

Настройте политику send-service-bus-message для отправки сообщений в нужную очередь или раздел.

Например, используйте send-service-bus-message политику в разделе входящей политики для отправки тела запроса API, когда шлюз его получает.

1. В портале Azure перейдите к вашему экземпляру API Management.

2. В меню слева выберите API, а затем выберите API, в котором нужно добавить политику.

3. Выберите все операции.

4. В верхней части экрана выберите вкладку "Конструктор ".

5. В окне обработки входящего трафика или исходящего трафика щелкните </> значок (редактор кода). Дополнительные сведения см. в разделе "Настройка или изменение политик".

6. Поместите курсор в раздел inbound или outbound политики.

7. Добавьте send-service-bus-message политику в конфигурацию политики, затем настройте атрибуты и элементы при необходимости.

   Например, отправьте текст запроса в виде сообщения:

   <send-service-bus-message queue-name="my-queue">
       <payload>@(context.Request.Body.As<string>())</payload>
   </send-service-bus-message>
   

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

8. Нажмите кнопку "Сохранить", чтобы сохранить обновленную конфигурацию политики. Как только вы её сохраните, политика становится активной и сообщения отправляются в назначенную сервисную шину.

Связанный контент

• Использование внешних служб
• Политика send-service-bus-message