Динамическая подготовка пространств имен и сущностей служебной шины
Служебная шина Azure предоставляет библиотеки, которые могут динамически подготавливать пространства имен и сущности служебной шины. Это дает возможность реализовывать сложные развертывания и сценарии обмена сообщениями и позволяет программно определять, какие сущности следует подготовить.
Обзор
Существует два подхода к программному управлению ресурсами служебной шины Azure. Первый — использование библиотек на основе Azure Resource Manager, которые позволяют управлять пространствами имен, очередями, разделами, подписками, правилами и политиками SAS. Библиотеки на основе Azure Resource Manager поддерживают проверку подлинности с помощью идентификатора Microsoft Entra, но не через строка подключения. Второй подход заключается в использовании тех же клиентских библиотек служебной шины, которые используются для отправки и получения сообщений. Клиентские библиотеки также предоставляют интерфейсы API, помогающие управлять очередями, разделами, подписками и правилами в имеющемся пространстве имен. Они поддерживают проверку подлинности с помощью строк подключения. При выборе похода учитывайте следующее.
Библиотеки на основе Azure Resource Manager предлагают те же функции, что и портал Azure, CLI и PowerShell, в отношении управления пространствами имен и сущностями служебной шины, такими как очереди, разделы, подписки и т. д. Если вы используете для выполнения операций управления портал Azure, CLI или PowerShell и хотели бы применить динамический подход, эти библиотеки могут оказаться оптимальным вариантом.
Однако если вы уже используете клиентскую библиотеку служебной шины для связанных со службой операций, таких как отправка и получение сообщений, а теперь вам нужно управлять сущностями служебной шины, возможно, вам будет удобнее использовать ту же библиотеку. Клиентские библиотеки имеют клиент ServiceBusAdministrationClient (в старых библиотеках это ServiceBusManagementClient), который предоставляет подмножество функций управления, предусмотренных в библиотеках на основе Azure Resource Manager. Необходимо подчеркнуть, что хотя библиотеки на основе Azure Resource Manager позволяют управлять пространствами имен и сущностями служебной шины, клиентские библиотеки позволяют управлять только сущностями в существующем пространстве имен, но самим пространством имен с их помощью управлять нельзя.
Управление с помощью библиотек на основе Azure Resource Manager
Библиотеки на основе Azure Resource Manager позволяют управлять пространствами имен, очередями, разделами, подписками, правилами и политиками SAS. Они поддерживают проверку подлинности только с идентификатором Microsoft Entra. Они не поддерживают строка подключения.
Библиотеки .NET и Java для Fluent
Для библиотек на основе Azure Resource Manager существует версия Fluent.
Управление с помощью клиентских библиотек служебной шины
Клиентские библиотеки служебной шины, используемые для таких операций, как отправка и получение сообщений, также можно использовать для управления очередями, разделами, подписками и правилами в имеющемся пространстве имен служебной шины. Эта функция доступна в клиенте ServiceBusAdministrationClient в новейших версиях библиотек и в клиенте ServiceBusManagementClient более старых библиотеках. Настоятельно рекомендуем использовать новейшие библиотеки.
Новейшие библиотеки служебной шины
| Язык | Пакет | Документация | Примеры |
|---|---|---|---|
| .NET | Azure.Messaging.ServiceBus | ServiceBusAdministrationClient | .NET |
| Java | azure-messaging-servicebus | ServiceBusAdministrationAsyncClient, ServiceBusAdministrationClient | Java |
| JavaScript | @azure/service-bus | ServiceBusAdministrationClient | JavaScript/TypeScript |
| Python | azure-servicebus | ServiceBusAdministrationClient | Python |
Устаревшие библиотеки служебной шины
| Язык | Пакет | Документация | Примеры |
|---|---|---|---|
| .NET | Microsoft.Azure.ServiceBus | ManagementClient | .NET |
| Java | azure-mgmt-servicebus | ManagementClientAsync, ManagementClient | Java |
30 сентября 2026 г. мы удалим библиотеки пакета SDK Служебная шина Azure WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus и com.microsoft.azure.servicebus, которые не соответствуют рекомендациям по пакету SDK Azure. Мы также завершим поддержку протокола SBMP, поэтому вы больше не сможете использовать этот протокол после 30 сентября 2026 года. Перейдите в последние библиотеки пакета SDK Azure, которые предлагают критически важные обновления системы безопасности и улучшенные возможности до этой даты.
Хотя старые библиотеки по-прежнему могут использоваться после 30 сентября 2026 года, они больше не будут получать официальную поддержку и обновления от Майкрософт. Дополнительные сведения см. в объявлении о выходе на пенсию в службу поддержки.
Следующие шаги
- Отправка сообщений в очередь и получение сообщений из очереди с помощью новейшей библиотеки служебной шины: .NET, Java, JavaScript, Python
- Отправка сообщений в раздел и получение сообщений из подписки с помощью новейшей библиотеки служебной шины: .NET, Java, JavaScript, Python