Partager via


Provisionnement dynamique d’espaces de noms et d’entités Service Bus

Les bibliothèques Azure Service Bus permettent d’approvisionner dynamiquement des entités et des espaces de noms Service Bus. Cela permet des déploiements et des scénarios de messagerie complexes, et rend possible la définition des entités à approvisionner par programmation.

Vue d'ensemble

Vous pouvez adopter deux approches programmatiques pour gérer les ressources Azure Service Bus. La première consiste à utiliser les bibliothèques basées sur Azure Resource Manager, qui vous permettent de gérer les espaces de noms, les files d’attente, les rubriques, les abonnements, les règles et les stratégies de signature d’accès partagé. Les bibliothèques basées sur Azure Resource Manager prennent en charge l’authentification via Microsoft Entra ID, et non via des chaînes de connexion. La deuxième approche consiste à exploiter les mêmes bibliothèques clientes Service Bus que celles que vous utilisez pour envoyer et recevoir des messages. Les bibliothèques clientes fournissent également des API pour vous aider à gérer les files d’attente, les rubriques, les abonnements et les règles dans un espace de noms existant. Elles prennent en charge l’authentification avec les chaînes de connexion. Lorsque vous décidez de l’approche à adopter, tenez compte des points suivants.

Les bibliothèques basées sur Azure Resource Manager offrent les mêmes fonctionnalités que le Portail Azure, l’interface CLI et PowerShell lorsqu’il s’agit de gérer les espaces de noms et les entités Service Bus comme les files d’attente, les sujets, les abonnements, etc. Si vous avez utilisé le Portail Azure, l’interface CLI ou PowerShell pour vos opérations de gestion et que vous souhaitez bénéficier d’un moyen dynamique de le faire, alors ces bibliothèques peuvent être mieux adaptées à vos besoins.

Toutefois, si vous utilisez déjà une bibliothèque cliente Service Bus pour les opérations spécifiques au service, telles que l’envoi et la réception de messages, et que vous devez également gérer les entités Service Bus, l’utilisation de la même bibliothèque peut être plus pratique pour vous. Les bibliothèques clientes possèdent un ServiceBusAdministrationClient (appelé ServiceBusManagementClient dans les bibliothèques plus anciennes) qui fournit un sous-ensemble des fonctionnalités de gestion fournies par les bibliothèques basées sur Azure Resource Manager. Il convient de souligner que, si les bibliothèques basées sur Azure Resource Manager vous permettent de gérer à la fois des espaces de noms et des entités Service Bus, les bibliothèques clientes vous permettent uniquement de gérer des entités dans un espace de noms existant, mais pas dans l’espace de noms lui-même.

Gérer à l’aide de bibliothèques basées sur Azure Resource Manager

Les bibliothèques basées sur Azure Resource Manager vous permettent de gérer les espaces de noms, les files d’attente, les rubriques, les abonnements, les règles et les stratégies de signature d’accès partagé. Elles prennent en charge l’authentification avec Microsoft Entra ID uniquement et ne prennent pas en charge les chaînes de connexion.

Langue Package Documentation Exemples
.NET Azure.ResourceManager.ServiceBus Informations de référence sur l’API Microsoft.Azure.Management.ServiceBus .NET
Java azure-resourcemanager-servicebus Informations de référence sur l’API com.azure-resourcemanager-servicebus Java
JavaScript @azure/arm-servicebus API reference for @azure/arm-servicebus
Python azure-mgmt-servicebus Informations de référence sur azure-mgmt-servicebus

Bibliothèques Fluent .NET et Java

Il existe une version Fluent des bibliothèques basées sur Azure Resource Manager.

Langage Package Documentation
.NET Microsoft.Azure.Management.ServiceBus.Fluent Informations de référence sur l’API Microsoft.Azure.Management.ServiceBus.Fluent
Java azure-resourcemanager-servicebus Informations de référence sur l’API com.azure-resourcemanager-servicebus.fluent

Gérer à l’aide des bibliothèques clientes Service Bus

Les bibliothèques clientes Service Bus qui sont utilisées pour des opérations telles que l’envoi et la réception de messages permettent également de gérer les files d’attente, les rubriques, les abonnements et les règles dans un espace de noms Service Bus existant. Cette fonctionnalité est disponible via le ServiceBusAdministrationClient dans les bibliothèques les plus récentes et via le ServiceBusManagementClient dans les bibliothèques plus anciennes. Nous vous recommandons vivement d’utiliser les bibliothèques les plus récentes.

Bibliothèques Service Bus les plus récentes

Langage Package Documentation Exemples
.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

Bibliothèques Service Bus héritées

Langage Package Documentation Exemples
.NET Microsoft.Azure.ServiceBus ManagementClient .NET
Java azure-mgmt-servicebus ManagementClientAsync, ManagementClient Java

Le 30 septembre 2026, nous retirerons les bibliothèques WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus et com.microsoft.azure.servicebus du kit de développement logiciel (SDK) Azure Service Bus, qui ne sont pas conformes aux directives du kit de développement logiciel (SDK) Azure. Nous mettrons également fin à la prise en charge du protocole SBMP. Vous ne pourrez donc plus utiliser ce protocole après le 30 septembre 2026. Migrez vers les dernières bibliothèques du kit de développement logiciel (SDK) Azure, qui offre des correctifs de sécurité critiques et des fonctionnalités améliorées, avant cette date.

Bien que les anciennes bibliothèques puissent toujours être utilisées au-delà du 30 septembre 2026, elles ne seront plus prises en charge officiellement et mises à jour par Microsoft. Pour plus d’informations, consultez l’annonce concernant l’arrêt de la prise en charge.

Étapes suivantes

  • Envoyer et recevoir des messages à partir de la file d’attente à l’aide de la dernière bibliothèque Azure Service Bus : .NET, Java, JavaScript, Python
  • Envoyer des messages à une rubrique et recevoir des messages à partir d’un abonnement à la dernière bibliothèque Service Bus : .NET, Java, JavaScript, Python