Azure Share-Clientbibliothek für .NET– Version 1.0.3-beta.20
Microsoft Purview Share ist ein vollständig verwalteter Clouddienst.
Verwenden Sie diese Bibliothek in hohem Maße auf die Dokumentation des Diensts und unsere Protokollclientdokumentation.
Quellcode | Paket (NuGet) | Produktdokumentation
Erste Schritte
Installieren des Pakets
Installieren Sie die Microsoft Purview Share-Clientbibliothek für .NET mit NuGet:
dotnet add package Azure.Analysis.Purview.Share --prerelease
Voraussetzungen
- Sie benötigen ein Azure-Abonnement und eine Purview-Ressource , um dieses Paket verwenden zu können.
Authentifizieren des Clients
Verwenden von Azure Active Directory
In diesem Dokument wird die Verwendung von DefaultAzureCredential zur Authentifizierung über Azure Active Directory veranschaulicht. Alle von Azure.Identity angebotenen Anmeldeinformationen werden jedoch akzeptiert. Weitere Informationen zu anderen Anmeldeinformationen finden Sie in der Dokumentation zu Azure.Identity .
Nachdem Sie Ihre Anmeldeinformationen ausgewählt und konfiguriert haben, können Sie Instanzen von AccountClient
erstellen.
var credential = new DefaultAzureCredential();
var client = new PurviewAccountClient(new Uri("https://<my-account-name>.purview.azure.com"), credential);
Wichtige Begriffe
Protokollmethoden
Vorgänge, die vom Purview Share SDK für .NET verfügbar gemacht werden, verwenden Protokollmethoden , um die zugrunde liegenden REST-Vorgänge verfügbar zu machen. Weitere Informationen zur Verwendung von SDK-Clients, die Protokollmethoden verwenden, finden Sie in unserer Dokumentation.
Threadsicherheit
Wir garantieren, dass alle Client-instance Methoden threadsicher und unabhängig voneinander sind (Richtlinie). Dadurch wird sichergestellt, dass die Empfehlung, Clientinstanzen wiederzuverwenden, immer sicher ist, auch über Threads hinweg.
Zusätzliche Konzepte
Clientoptionen | Zugreifen auf die Antwort | Vorgänge | mit langer AusführungsdauerBehandeln von Fehlern | Diagnose | Spott | Clientlebensdauer
Beispiele
Im folgenden Abschnitt wird gezeigt, wie Sie Ihren Client initialisieren und authentifizieren und eine gesendete Freigabe erhalten.
Abrufen einer gesendeten Freigabe
var credential = new DefaultAzureCredential();
var client = new SentSharesClient(new Uri("https://<my-account-name>.purview.azure.com"), credential);
var response = await client.GetSentShareAsync("sentShare", new());
var responseDocument = JsonDocument.Parse(response.Content);
Console.WriteLine(responseDocument.RootElement.GetProperty("name"));
Problembehandlung
Einrichten der Konsolenprotokollierung
Die einfachste Möglichkeit, die Protokolle anzuzeigen, besteht darin, die Konsolenprotokollierung zu aktivieren. Verwenden Sie die AzureEventSourceListener.CreateConsoleLogger-Methode, um einen Azure SDK-Protokolllistener zu erstellen, der Nachrichten an die Konsole ausgibt.
// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();
Weitere Informationen zu anderen Protokollierungsmechanismen finden Sie hier.
Nächste Schritte
Dieses Client-SDK macht Vorgänge mit Protokollmethoden verfügbar. Weitere Informationen zur Verwendung von SDK-Clients, die Protokollmethoden verwenden, finden Sie in unserer Dokumentation.
Mitwirken
Ausführliche Informationen zum Erstellen, Testen und Mitwirken zu dieser Bibliothek finden Sie im CONTRIBUTING.md .
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. Weitere Informationen finden Sie unter 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 ausführen, die unsere CLA verwenden.
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.
Azure SDK for .NET