Azure Service Bus Management-Clientbibliothek für .NET– Version 1.0.0

  • Artikel

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 Service Bus-Verwaltungsbibliothek für .NET mit NuGet:

dotnet add package Azure.ResourceManager.ServiceBus

Voraussetzungen

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

Unter anderem gibt es folgende Optionen:

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 Dokumentationen für die Azure.Identity.DefaultAzureCredential Klasse finden Sie in diesem Dokument.

Wichtige Begriffe

Wichtige Konzepte des Azure .NET SDK finden Sie hier.

Dokumentation

Es steht eine Dokumentation zur Verfügung, die Ihnen hilft, zu erfahren, wie Sie dieses Paket verwenden.

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";
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
AzureLocation location = AzureLocation.EastUS2;
ServiceBusNamespaceResource serviceBusNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new ServiceBusNamespaceData(location))).Value;

Abrufen aller Namespaces in einer Ressourcengruppe

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

Abrufen eines Namespace

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

Löschen eines Namespaces

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

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

Problembehandlung

  • Melden eines Problems über GitHub Issues
  • Überprüfen Sie vorherige Fragen , oder stellen Sie neue Fragen in Stack Overflow mithilfe von Azure- und .NET-Tags.

Nächste Schritte

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.