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.
Bibliothèques Fluent .NET et Java
Il existe une version Fluent des bibliothèques basées sur Azure Resource Manager.
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