bibliothèque de client Azure Service Bus Management pour .NET - version 1.0.0

Article
04/18/2023

Ce package suit les nouvelles instructions du Kit de développement logiciel (SDK) Azure qui fournissent un certain nombre de fonctionnalités de base partagées entre tous les kits SDK Azure, notamment la bibliothèque d’identités Azure intuitive, un pipeline HTTP avec des stratégies personnalisées, la gestion des erreurs, le suivi distribué et bien plus encore.

Prise en main

Installer le package

Installez la bibliothèque de gestion Azure Service Bus pour .NET avec NuGet :

dotnet add package Azure.ResourceManager.ServiceBus

Prérequis

Configurez un moyen de s’authentifier auprès d’Azure avec Azure Identity.

Voici quelques options :

Via la connexion Azure CLI.
Via Visual Studio.
Définition des variables d’environnement.

Vous trouverez plus d’informations et différentes approches d’authentification à l’aide d’Azure Identity dans ce document.

Authentifier le client

L'option par défaut pour créer un client authentifié consiste à utiliser DefaultAzureCredential. Comme toutes les API de gestion passent par le même point de terminaison, pour interagir avec les ressources, un seul niveau supérieur ArmClient doit être créé.

Pour vous authentifier auprès d’Azure et créer un ArmClient, procédez comme suit :

using Azure.Identity;

ArmClient armClient = new ArmClient(new DefaultAzureCredential());

Vous trouverez une documentation supplémentaire pour la Azure.Identity.DefaultAzureCredential classe dans ce document.

Concepts clés

Vous trouverez les concepts clés du Kit de développement logiciel (SDK) Azure .NET ici

Documentation

La documentation est disponible pour vous aider à apprendre à utiliser ce package

Exemples

Créer un espace de noms

Avant de créer un espace de noms, nous devons disposer d’un groupe de ressources.

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();

string rgName = "myRgName";
AzureLocation location = AzureLocation.WestUS2;
ArmOperation<ResourceGroupResource> operation = await subscription.GetResourceGroups().CreateOrUpdateAsync(WaitUntil.Completed, rgName, new ResourceGroupData(location));
ResourceGroupResource resourceGroup = operation.Value;

Ensuite, nous pouvons créer un espace de noms à l’intérieur de ce groupe de ressources.

string namespaceName = "myNamespace";
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
AzureLocation location = AzureLocation.EastUS2;
ServiceBusNamespaceResource serviceBusNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new ServiceBusNamespaceData(location))).Value;

Obtenir tous les espaces de noms d’un groupe de ressources

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
await foreach (ServiceBusNamespaceResource serviceBusNamespace in namespaceCollection.GetAllAsync())
{
    Console.WriteLine(serviceBusNamespace.Id.Name);
}

Obtenir un espace de noms

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
Console.WriteLine(serviceBusNamespace.Id.Name);

Supprimer un espace de noms

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
await serviceBusNamespace.DeleteAsync(WaitUntil.Completed);

Pour obtenir des exemples plus détaillés, consultez les exemples que nous proposons.

Dépannage

Fichier d’un problème via Github Issues
Vérifiez les questions précédentes ou posez-en de nouvelles sur Stack Overflow à l’aide de balises azure et .net.

Étapes suivantes

Pour plus d’informations sur le Kit de développement logiciel (SDK) Azure, reportez-vous à ce site web.

Contribution

Pour plus d’informations sur la contribution à ce dépôt, consultez le guide de contribution.

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devrez le faire qu’une seule fois sur tous les dépôts à l’aide de notre cla cla cla.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Partager via