bibliothèque cliente de gestion Azure Event Hubs 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 principales partagées entre tous les 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 Event Hubs pour .NET avec NuGet :

dotnet add package Azure.ResourceManager.EventHubs

Prérequis

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

En 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

Les concepts clés du Kit de développement logiciel (SDK) Azure .NET sont disponibles ici.

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";
EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
AzureLocation location = AzureLocation.EastUS2;
EventHubsNamespaceResource eventHubNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new EventHubsNamespaceData(location))).Value;

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

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
await foreach (EventHubsNamespaceResource eventHubNamespace in namespaceCollection.GetAllAsync())
{
    Console.WriteLine(eventHubNamespace.Id.Name);
}

Obtenir un espace de noms

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
Console.WriteLine(eventHubNamespace.Id.Name);

Suppression d’un espace de noms

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
await eventHubNamespace.DeleteAsync(WaitUntil.Completed);

Ajouter une balise à l’espace de noms

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
await eventHubNamespace.AddTagAsync("key","value");

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

Dépannage

Si vous trouvez un bogue ou si vous avez une suggestion, envoyez un problème via les problèmes GitHub et veillez à ajouter l’étiquette « Préversion » au problème.
Si vous avez besoin d’aide, case activée questions précédentes ou posez-en de nouvelles sur StackOverflow à l’aide de balises azure et .NET.
En cas de problème avec l’authentification, accédez à DefaultAzureCredential documentation

Étapes suivantes

Autres exemples de code

Gestion d’EventHubs

Documentation complémentaire

Pour plus d’informations sur le Kit de développement logiciel (SDK) Azure, consultez 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 n’aurez besoin de le faire qu’une seule fois sur tous les dépôts à l’aide de notre 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