Azure Event Hubs Management-Clientbibliothek für .NET– Version 1.0.0

Artikel
10/05/2023

Dieses Paket folgt den neuen Azure SDK-Richtlinien , die eine Reihe von Kernfunktionen bereitstellen, die von allen Azure SDKs gemeinsam genutzt werden, darunter die intuitive Azure Identity-Bibliothek, eine HTTP-Pipeline mit benutzerdefinierten Richtlinien, Fehlerbehandlung, verteilte Ablaufverfolgung und vieles mehr.

Erste Schritte

Installieren des Pakets

Installieren Sie die Azure Event Hubs-Verwaltungsbibliothek für .NET mit NuGet:

dotnet add package Azure.ResourceManager.EventHubs

Voraussetzungen

Einrichten einer Möglichkeit zum Authentifizieren bei Azure mit Azure Identity.

Unter anderem gibt es folgende Optionen:

Über die Azure CLI-Anmeldung.
Über Visual Studio.
Festlegen von Umgebungsvariablen.

Weitere Informationen und verschiedene Authentifizierungsansätze mit Azure Identity finden Sie in diesem Dokument.

Authentifizieren des Clients

Die Standardoption zum Erstellen eines authentifizierten Clients ist die Verwendung von DefaultAzureCredential. Da alle Verwaltungs-APIs denselben Endpunkt verwenden, muss nur eine oberste Ebene ArmClient erstellt werden, um mit Ressourcen zu interagieren.

Gehen Sie wie folgt vor, um sich bei Azure zu authentifizieren und einen ArmClient zu erstellen:

using Azure.Identity;

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

Weitere Dokumentation für die Azure.Identity.DefaultAzureCredential Klasse finden Sie in diesem Dokument.

Wichtige Begriffe

Wichtige Konzepte des Azure .NET SDK finden Sie hier.

Beispiele

Erstellen eines Namespace

Vor dem Erstellen eines Namespace benötigen wir eine Ressourcengruppe.

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;

Anschließend können wir einen Namespace innerhalb dieser Ressourcengruppe erstellen.

string namespaceName = "myNamespace";
EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
AzureLocation location = AzureLocation.EastUS2;
EventHubsNamespaceResource eventHubNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new EventHubsNamespaceData(location))).Value;

Abrufen aller Namespaces in einer Ressourcengruppe

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

Abrufen eines Namespace

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

Löschen eines Namespaces

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

Hinzufügen eines Tags zum Namespace

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

Ausführlichere Beispiele finden Sie in den verfügbaren Beispielen.

Problembehandlung

Wenn Sie einen Fehler finden oder einen Vorschlag haben, melden Sie ein Problem über GitHub Issues , und stellen Sie sicher, dass Sie dem Problem die Bezeichnung "Vorschau" hinzufügen.
Wenn Sie Hilfe benötigen, überprüfen Sie frühere Fragen, oder stellen Sie neue Fragen mit Azure- und .NET-Tags in StackOverflow.
Wenn Probleme mit der Authentifizierung auftreten, wechseln Sie zur Dokumentation zu DefaultAzureCredential.

Nächste Schritte

Weiterer Beispielcode

Verwalten von EventHubs

Zusätzliche Dokumentation

Weitere Informationen zum Azure SDK finden Sie auf dieser Website.

Mitwirken

Ausführliche Informationen zum Mitwirken an diesem Repository finden Sie im Leitfaden zum Mitwirken.

Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Ausführliche Informationen finden Sie unter https://cla.microsoft.com.

Wenn Sie einen Pull Request (PR) übermitteln, überprüft ein CLA-Bot automatisch, ob Sie eine Lizenzvereinbarung bereitstellen und den PR entsprechend ergänzen müssen (z.B. mit einer Bezeichnung oder einem Kommentar). Führen Sie einfach die Anweisungen des Bots aus. Sie müssen dies nur einmal für alle Repositorys mit unserer CLA tun.

Für dieses Projekt gelten die Microsoft-Verhaltensregeln für Open Source (Microsoft Open Source Code of Conduct). Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex. Sie können sich auch an opencode@microsoft.com wenden, wenn Sie weitere Fragen oder Anmerkungen haben.

Freigeben über