Share via


Service Bus-naamruimten en -entiteiten dynamisch inrichten

Azure Service Bus biedt bibliotheken om Service Bus-naamruimten en -entiteiten dynamisch in te richten. Dit maakt complexe implementaties en berichtenscenario's mogelijk en maakt het mogelijk programmatisch te bepalen welke entiteiten moeten worden ingericht.

Overzicht

Er zijn twee manieren om Azure Service Bus-resources programmatisch te beheren. De eerste is het gebruik van de op Azure Resource Manager gebaseerde bibliotheken, waarmee u naamruimten, wachtrijen, onderwerpen, abonnementen, regels en SAS-beleid kunt beheren. Op Azure Resource Manager gebaseerde bibliotheken bieden ondersteuning voor verificatie via Microsoft Entra ID, maar niet via verbindingsreeks s. De tweede methode is om gebruik te maken van dezelfde Service Bus-clientbibliotheken die u gebruikt om berichten te verzenden en te ontvangen. De clientbibliotheken bieden ook API's om u te helpen bij het beheren van wachtrijen, onderwerpen, abonnementen en regels in een bestaande naamruimte. Ze hebben ondersteuning voor verificatie met verbindingsreeks s. Houd rekening met het volgende wanneer u besluit welke aanpak u moet nemen.

De op Azure Resource Manager gebaseerde bibliotheken bieden dezelfde functionaliteit als Azure Portal, CLI en PowerShell als het gaat om het beheren van Service Bus-naamruimten en entiteiten, zoals wachtrijen, onderwerpen, abonnementen, enzovoort. Als u Azure Portal, CLI of PowerShell hebt gebruikt voor uw beheerbewerkingen en u dit dynamisch wilt doen, zijn deze bibliotheken mogelijk een betere keuze voor u.

Als u echter al een Service Bus-clientbibliotheek gebruikt voor servicespecifieke bewerkingen, zoals het verzenden en ontvangen van berichten, en u ook Service Bus-entiteiten moet beheren, kan het handiger zijn om dezelfde bibliotheek voor u te gebruiken. De clientbibliotheken hebben een ServiceBusAdministrationClient (in de oudere bibliotheken genoemd ServiceBusManagementClient ) die een subset biedt van de beheerfuncties die worden geleverd door de Op Azure Resource Manager gebaseerde bibliotheken. Het moet worden benadrukt dat hoewel u met de op Azure Resource Manager gebaseerde bibliotheken zowel Service Bus-naamruimten als entiteiten kunt beheren, de clientbibliotheken u alleen toestaan om entiteiten in een bestaande naamruimte te beheren, maar niet de naamruimte zelf.

Beheren met azure Resource Manager-bibliotheken

Met de op Azure Resource Manager gebaseerde bibliotheken kunt u naamruimten, wachtrijen, onderwerpen, abonnementen, regels en SAS-beleid beheren. Ze ondersteunen alleen verificatie met Microsoft Entra-id; ze bieden geen ondersteuning voor verbindingsreeks s.

Taal Pakket Documentatie Voorbeelden
.NET Azure.ResourceManager.ServiceBus API-naslaginformatie voor Microsoft.Azure.Management.ServiceBus .NET
Java azure-resourcemanager-servicebus API-verwijzing voor com.azure.resourcemanager.servicebus Java
JavaScript @azure/arm-servicebus API reference for @azure/arm-servicebus
Python azure-mgmt-servicebus API-naslaginformatie voor azure-mgmt-servicebus

Fluent .NET- en Java-bibliotheken

Er is een Fluent-versie van de Bibliotheken op basis van Azure Resource Manager.

Taal Pakket Documentatie
.NET Microsoft.Azure.Management.ServiceBus.Fluent API-naslaginformatie voor Microsoft.Azure.Management.ServiceBus.Fluent
Java azure-resourcemanager-servicebus API-naslaginformatie voor com.azure.resourcemanager.servicebus.fluent

Beheren met Service Bus-clientbibliotheken

Service Bus-clientbibliotheken die worden gebruikt voor bewerkingen zoals verzenden en ontvangen van berichten, kunnen ook worden gebruikt voor het beheren van wachtrijen, onderwerpen, abonnementen en regels in een bestaande Service Bus-naamruimte. Deze functie is beschikbaar via de ServiceBusAdministrationClient nieuwste bibliotheken en via de ServiceBusManagementClient oudere bibliotheken. Het wordt ten zeerste aanbevolen dat u de nieuwste bibliotheken gebruikt.

Nieuwste Service Bus-bibliotheken

Taal Pakket Documentatie Voorbeelden
.NET Azure.Messaging.ServiceBus ServiceBus Beheer istrationClient .NET
Java azure-messaging-servicebus ServiceBus Beheer istrationAsyncClient, ServiceBus Beheer istrationClient Java
JavaScript @azure/servicebus ServiceBus Beheer istrationClient JavaScript TypeScript/
Python azure-servicebus ServiceBus Beheer istrationClient Python

Verouderde Service Bus-bibliotheken

Taal Pakket Documentatie Voorbeelden
.NET Microsoft.Azure.ServiceBus ManagementClient .NET
Java azure-mgmt-servicebus ManagementClientAsync, ManagementClient Java

Op 30 september 2026 gaan we de Azure Service Bus SDK-bibliotheken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus en com.microsoft.azure.servicebus buiten gebruik stellen, die niet voldoen aan de Azure SDK-richtlijnen. We beëindigen ook de ondersteuning van het SBMP-protocol, zodat u dit protocol na 30 september 2026 niet meer kunt gebruiken. Migreer naar de nieuwste Azure SDK-bibliotheken, die vóór die datum essentiële beveiligingsupdates en verbeterde mogelijkheden bieden.

Hoewel de oudere bibliotheken nog steeds meer dan 30 september 2026 kunnen worden gebruikt, ontvangen ze geen officiële ondersteuning en updates meer van Microsoft. Zie de aankondiging van de buitengebruikstelling van de ondersteuning voor meer informatie.

Volgende stappen

  • Berichten verzenden naar en berichten ontvangen uit de wachtrij met behulp van de nieuwste Service Bus-bibliotheek: .NET, Java, JavaScript, Python
  • Berichten verzenden naar onderwerp en berichten ontvangen van een abonnement met behulp van de nieuwste Service Bus-bibliotheek:NET, Java, JavaScript, Python