Bibliothèque cliente Azure Share pour .NET - version 1.0.3-beta.20

  • Article

Microsoft Purview Share est un service cloud entièrement managé.

Veuillez vous appuyer largement sur la documentation du service et sur notre documentation cliente de protocole pour utiliser cette bibliothèque

| Code sourcePackage (NuGet) | Documentation produit

Prise en main

Installer le package

Installez la bibliothèque de client Microsoft Purview Share pour .NET avec NuGet :

dotnet add package Azure.Analysis.Purview.Share --prerelease

Prérequis

Authentifier le client

Utilisation d’Azure Active Directory

Ce document illustre l’utilisation de DefaultAzureCredential pour l’authentification via Azure Active Directory. Toutefois, toutes les informations d’identification proposées par Azure.Identity seront acceptées. Pour plus d’informations sur les autres informations d’identification, consultez la documentation Azure.Identity .

Une fois que vous avez choisi et configuré vos informations d’identification, vous pouvez créer des instances de .AccountClient

var credential = new DefaultAzureCredential();
var client = new PurviewAccountClient(new Uri("https://<my-account-name>.purview.azure.com"), credential);

Concepts clés

Méthodes de protocole

Les opérations exposées par le Kit de développement logiciel (SDK) Purview Share pour .NET utilisent des méthodes de protocole pour exposer les opérations REST sous-jacentes. Pour en savoir plus sur l’utilisation des clients sdk qui utilisent des méthodes de protocole, consultez notre documentation.

Sécurité des threads

Nous garantissons que toutes les méthodes de instance client sont thread-safe et indépendantes les unes des autres (instructions). Cela garantit que la recommandation de réutilisation des instances clientes est toujours sécurisée, même entre les threads.

Concepts supplémentaires

Options | du clientAccès à la réponse | Opérations | de longue duréeGestion des défaillances | Diagnostics | Moqueur | Durée de vie du client

Exemples

La section suivante vous montre comment initialiser et authentifier votre client et obtenir un partage envoyé.

Obtenir un partage envoyé

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"));

Résolution des problèmes

Configuration de la journalisation de la console

La façon la plus simple de voir les journaux consiste à activer la journalisation de la console. Pour créer un écouteur de journal du Kit de développement logiciel (SDK) Azure qui génère des messages dans la console, utilisez la méthode AzureEventSourceListener.CreateConsoleLogger.

// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();

Pour en savoir plus sur les autres mécanismes de journalisation , consultez ici.

Étapes suivantes

Ce Kit de développement logiciel (SDK) client expose les opérations à l’aide de méthodes de protocole. Vous pouvez en savoir plus sur l’utilisation des clients sdk qui utilisent des méthodes de protocole dans notre documentation.

Contribution

Consultez la CONTRIBUTING.md pour plus d’informations sur la création, le test et la contribution à cette bibliothèque.

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 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 devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat 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.

Impressions