Démarrage rapide de l’API Fabric

2025-06-11

Présentation

Pour utiliser des API Fabric, comme de nombreux autres services Microsoft, vous devez d’abord obtenir un jeton Microsoft Entra pour le service Fabric, puis utiliser ce jeton dans l’en-tête d’autorisation de l’appel d’API.

Dans ce tutoriel de démarrage rapide, vous allez créer une application console en C#, qui acquiert un jeton d'ID Entra à l’aide de la bibliothèque MSAL.Net, puis utiliser HttpClient en C# pour appeler l'API de liste des espaces de travail.

Créer un enregistrement d'application

Pour obtenir un jeton Microsoft Entra, vous devez d’abord inscrire une application avec l’ID Microsoft Entra.

Pour en savoir plus sur l’inscription d’une application et de différentes propriétés de l’application et la façon dont elle peut s’appliquer à votre scénario, consultez Inscrire une application dans la plateforme d’identités Microsoft.

Dans ce tutoriel de démarrage rapide, vous allez créer un client public avec l’URI de redirection = http://localhost

Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
Accédez à Applications > Enregistrements d'applications.
Cliquez sur Nouvelle inscription.
Entrez un nom d'affichage pour votre application et ajoutez l'URI de redirection du client public http://localhost
Sélectionnez Inscrire.
Copiez l’ID d’application (client) et collez-le dans un bloc-notes pour être utilisé ultérieurement.

Capture d’écran montrant une application dans Azure après l'enregistrement.

Obtenir un jeton

Dans ce tutoriel, vous allez utiliser MSAL.Net pour acquérir un jeton d’ID Entra pour le service Fabric avec les étendues suivantes : Workspace.ReadWrite.All, Item.ReadWrite.All.

Pour plus d’informations sur l’acquisition de jetons avec MSAL.Net, consultez Acquisition de jetons – Bibliothèque d’authentification Microsoft pour .NET.

Collez l’ID d’application (client) que vous avez copié précédemment et collez-le pour la variable ClientId.

Exemple de code C# pour l’acquisition d’un jeton d’accès Microsoft Entra

#region parameters section 
string ClientId = "YourApplicationId"; 
string Authority = "https://login.microsoftonline.com/organizations"; 
string RedirectURI = "http://localhost"; 
#endregion 

#region Acquire a token for Fabric APIs 
// In this sample we acquire a token for Fabric service with the scopes  
// Workspace.ReadWrite.All and Item.ReadWrite.All 
string[] scopes = new string[] { "https://api.fabric.microsoft.com/Workspace.ReadWrite.All https://api.fabric.microsoft.com/Item.ReadWrite.All" }; 

PublicClientApplicationBuilder PublicClientAppBuilder = 
        PublicClientApplicationBuilder.Create(ClientId) 
        .WithAuthority(Authority) 
        .WithRedirectUri(RedirectURI); 

IPublicClientApplication PublicClientApplication = PublicClientAppBuilder.Build(); 

AuthenticationResult result = await PublicClientApplication.AcquireTokenInteractive(scopes) 
        .ExecuteAsync() 
        .ConfigureAwait(false); 

Console.WriteLine(result.AccessToken); 
#endregion

API Des espaces de travail de liste d’appels

Dans cette section, vous allez :

Créez le HttpClient C# avec le jeton que nous avons acquis dans la section précédente.
Ajoutez https://api.fabric.microsoft.com/v1/ comme URL de base pour le client.
Appeler l'API pour lister les espaces de travail et inscrire la réponse dans la console.

Exemple de code C# de création d’un client http et d’appel de l’API Espaces de travail de liste

// Create client 
HttpClient client = new HttpClient(); 
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", result.AccessToken); 
string baseUrl = "https://api.fabric.microsoft.com/v1/"; 
client.BaseAddress = new Uri(baseUrl); 

// Call list workspaces API 
HttpResponseMessage response = await client.GetAsync("workspaces"); 
string responseBody = await response.Content.ReadAsStringAsync(); 
Console.WriteLine(responseBody);

Exemple de code d’application console C# complet

using Microsoft.Identity.Client; 
using System.Net.Http.Headers; 

#region parameters section 
string ClientId = "YourApplicationId";  
string Authority = "https://login.microsoftonline.com/organizations"; 
string RedirectURI = "http://localhost";  
#endregion 

#region Acquire a token for Fabric APIs 
// In this sample we acquire a token for Fabric service with the scopes Workspace.ReadWrite.All and Item.ReadWrite.All 
string[] scopes = new string[] { "https://api.fabric.microsoft.com/Workspace.ReadWrite.All https://api.fabric.microsoft.com/Item.ReadWrite.All" }; 

PublicClientApplicationBuilder PublicClientAppBuilder = 
        PublicClientApplicationBuilder.Create(ClientId) 
        .WithAuthority(Authority) 
        .WithRedirectUri(RedirectURI); 

IPublicClientApplication PublicClientApplication = PublicClientAppBuilder.Build(); 

AuthenticationResult result = await PublicClientApplication.AcquireTokenInteractive(scopes) 
        .ExecuteAsync() 
        .ConfigureAwait(false); 

Console.WriteLine(result.AccessToken); 
#endregion 

#region Create an HTTP client and call the Fabric APIs 
// Create client 
HttpClient client = new HttpClient(); 
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", result.AccessToken); 
string baseUrl = "https://api.fabric.microsoft.com/v1/"; 
client.BaseAddress = new Uri(baseUrl); 

// Call list workspaces API 
HttpResponseMessage response = await client.GetAsync("workspaces"); 
string responseBody = await response.Content.ReadAsStringAsync(); 
Console.WriteLine(responseBody); 
#endregion

Partager via