Dynamisches Bereitstellen von Service Bus-Namespaces und -Entitäten
Azure Service Bus bietet Bibliotheken zur dynamischen Bereitstellung von Service Bus-Namespaces und -Entitäten. Dies ermöglicht komplexe Bereitstellungen und Messagingszenarios sowie eine programmgesteuerte Bestimmung der bereitzustellenden Entitäten.
Übersicht
Es gibt zwei Ansätze, um Azure Service Bus-Ressourcen programmgesteuert zu verwalten. Der erste Ansatz besteht darin, die auf Azure Resource Manager basierenden Bibliotheken zu verwenden, mit denen Sie Namespaces, Warteschlangen, Themen, Abonnements, Regeln und SAS-Richtlinien verwalten können. Azure Resource Manager-basierte Bibliotheken unterstützen die Authentifizierung über Microsoft Entra ID, aber nicht über Verbindungszeichenfolgen. Der zweite Ansatz besteht darin, dieselben Clientbibliotheken des Diensts zu nutzen, die Sie zum Senden und Empfangen von Nachrichten verwenden. Die Clientbibliotheken stellen auch APIs zur Verfügung, mit deren Hilfe Sie Warteschlangen, Themen, Abonnements und Regeln in einem vorhandenen Namespace verwalten können. Sie bieten Unterstützung für die Authentifizierung mit Verbindungszeichenfolgen. Bei der Entscheidung, welchen Ansatz Sie wählen, sollten Sie Folgendes berücksichtigen.
Die auf Azure Resource Manager basierenden Bibliotheken bieten dieselbe Funktionalität wie das Azure-Portal, die Azure CLI und PowerShell, wenn es um die Verwaltung von Service Bus-Namespaces und -Entitäten wie Warteschlangen, Themen, Abonnements usw. geht. Wenn Sie das Azure-Portal, die Azure CLI oder PowerShell für Ihre Verwaltungsvorgänge verwendet haben und eine dynamische Möglichkeit dafür suchen, dann sind diese Bibliotheken vielleicht besser für Sie geeignet.
Wenn Sie jedoch bereits eine Clientbibliothek für dienstspezifische Vorgänge wie das Senden und Empfangen von Nachrichten verwenden und auch Service Bus-Entitäten verwalten müssen, dann ist es möglicherweise bequemer, dieselbe Bibliothek zu verwenden. Die Clientbibliotheken verfügen über ein ServiceBusAdministrationClient (in älteren Bibliotheken als ServiceBusManagementClient bezeichnet), das eine Teilmenge der von den Azure Resource Manager-basierten Bibliotheken bereitgestellten Verwaltungsfunktionen bietet. Es muss betont werden, dass die auf Azure Resource Manager basierenden Bibliotheken es Ihnen ermöglichen, sowohl Service Bus-Namespaces als auch -Entitäten zu verwalten, während die Clientbibliotheken nur die Verwaltung von Entitäten in einem bestehenden Namespace ermöglichen, nicht aber die Verwaltung des Namespace selbst.
Verwalten mit Azure Resource Manager-basierten Bibliotheken
Die auf Azure Resource Manager basierenden Bibliotheken ermöglichen es Ihnen, Namespaces, Warteschlangen, Themen, Abonnements, Regeln und SAS-Richtlinien zu verwalten. Sie unterstützen nur die Authentifizierung mit Microsoft Entra ID. Sie unterstützen keine Verbindungszeichenfolgen.
| Sprache | Paket | Dokumentation | Beispiele |
|---|---|---|---|
| .NET | Azure.ResourceManager.ServiceBus | API-Referenz für Microsoft.Azure.Management.ServiceBus | .NET |
| Java | azure-resourcemanager-servicebus | API-Referenz für com.azure.resourcemanager.servicebus | Java |
| JavaScript | @azure/arm-servicebus | API reference for @azure/arm-servicebus | |
| Python | azure-mgmt-servicebus | API-Referenz für azure-mgmt-servicebus |
Fluent .NET- und Java-Bibliotheken
Es gibt eine Fluent-Version der Azure Resource Manager-basierten Bibliotheken.
Verwalten mit Service Bus-Clientbibliotheken
Service Bus-Clientbibliotheken, die für Vorgänge wie das Senden und Empfangen von Nachrichten verwendet werden, können auch zur Verwaltung von Warteschlangen, Themen, Abonnements und Regeln in einem vorhandenen Service Bus-Namespace verwendet werden. Dieses Feature ist über ServiceBusAdministrationClient in den neuesten Bibliotheken und über ServiceBusManagementClient in den älteren Bibliotheken verfügbar. Es wird dringend empfohlen, dass Sie die neuesten Bibliotheken verwenden.
Neueste Service Bus-Bibliotheken
| Sprache | Paket | Dokumentation | Beispiele |
|---|---|---|---|
| .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 |
Legacy-Service Bus-Bibliotheken
| Sprache | Paket | Dokumentation | Beispiele |
|---|---|---|---|
| .NET | Microsoft.Azure.ServiceBus | ManagementClient | .NET |
| Java | azure-mgmt-servicebus | ManagementClientAsync, ManagementClient | Java |
Am 30. September 2026 werden die Azure Service Bus SDK-Bibliotheken „WindowsAzure.ServiceBus“, „Microsoft.Azure.ServiceBus“ und „com.microsoft.azure.servicebus“ eingestellt, da sie nicht den Azure SDK-Richtlinien entsprechen. Außerdem wird die Unterstützung des SBMP-Protokolls beendet, sodass Sie dieses Protokoll nach dem 30. September 2026 nicht mehr verwenden können. Migrieren Sie vor diesem Datum zu den neuesten Azure SDK-Bibliotheken, die wichtige Sicherheitsupdates und verbesserte Funktionen bieten.
Obwohl die älteren Bibliotheken noch über den 30. September 2026 hinaus verwendet werden können, erhalten sie keinen offiziellen Support und keine Updates mehr von Microsoft. Weitere Informationen finden Sie in der Ankündigung der Supporteinstellung.
Nächste Schritte
- Senden von Nachrichten an die Warteschlange und Empfangen von Nachrichten aus der Warteschlange mithilfe der neuesten Service Bus-Bibliothek: .NET, Java, JavaScript, Python
- Senden von Nachrichten an ein Thema und Empfangen von Nachrichten von einem Abonnement mithilfe der neuesten Service Bus-Bibliothek: .NET, Java, JavaScript, Python