Fabric-ohjelmointirajapinnan pika-aloitus

Esittely

Jotta voit käyttää Fabric-ohjelmointirajapintoja, kuten monia muita Microsoft-palveluita, sinun on ensin hankittava Microsoft Entra -tunnus Fabric-palvelulle ja käytettävä sitten tunnusta API-kutsun valtuutusotsikossa.

Tässä pikaoppaan opetusohjelmassa luot C#-konsolisovelluksen, joka saa Entra ID -tunnuksen MSAL.Net kirjaston avulla ja kutsuu sitten Luettelotyötilat-ohjelmointirajapinnan C# HttpClient-toiminnolla.

Sovelluksen rekisteröinnin luominen

Jos haluat hankkia Microsoft Entra -tunnuksen, sinun on ensin rekisteröitävä sovellus Microsoft Entra -tunnuksella.

Lisätietoja sovelluksen rekisteröinnistä ja sovelluksen eri ominaisuuksista sekä siitä, miten se voisi olla sovellettavissa skenaarioosi, on artikkelissa Sovelluksen rekisteröiminen Microsoftin käyttäjätietoympäristössä.

Tässä pikaoppaan opetusohjelmassa luot julkisen asiakkaan uudelleenohjauksen URI : n avulla = http://localhost

Kirjaudu sisään Microsoft Entra -hallintakeskukseen vähintään pilvipalvelusovelluksen järjestelmänvalvojan.
Selaa kohtaan Sovellukset > Sovelluksen rekisteröinnit.
Valitse Uusi rekisteröinti.
Anna sovellukselle näyttönimi ja lisää Julkisen asiakkaan uudelleenohjauksen URI http://localhost
Valitse Rekisteröi.
Kopioi sovelluksen (asiakasohjelman) tunnus ja liitä se muistioon, jota käytetään myöhemmin.

Näyttökuvassa näkyy sovellus Azure-julkaisurekisteröinnissä.

Hanki tunnus

Tässä opetusohjelmassa hankit MSAL.Net Entra ID -tunnuksen Fabric-palvelulle seuraavilla vaikutusalueilla: Workspace.ReadWrite.All, Item.ReadWrite.All.

Lisätietoja tunnuksen hankkimisesta MSAL.Net kohteeseen on kohdassa Tunnuksen hankinta – Microsoftin todentamiskirjasto .NET:lle.

Liitä aiemmin kopioimasi Sovellus (asiakas) -tunnus ja liitä se ClientId-muuttujaa varten.

C#-koodimalli Microsoft Entra -käyttöoikeustietueen hankkimiseen

#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

Kutsuluettelon työtilojen ohjelmointirajapinta

Tässä osiossa teet:

Luo C# HttpClient edellisessä osiossa hankkimamme tunnuksen avulla.
Lisää https://api.fabric.microsoft.com/v1/ asiakkaan PERUS-URL-osoitteena.
Kutsuluettelon työtilojen ohjelmointirajapinta ja kirjoita vastaus konsoliin.

C#-koodiesimerkki http-asiakkaan luomisesta ja luettelotyötilojen ohjelmointirajapinnan kutsumisesta

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

Full C# -konsolisovelluksen koodiesimerkki

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

Last updated on 2025-06-11