Microsoft.Fabric.Api 1.0.0-beta

Guide to Using the .NET SDK for Microsoft Fabric REST API

Description

The Microsoft Fabric API provides developers with programmatic access to manage and interact with Microsoft Fabric resources. It enables developers to automate a wide array of tasks, including data integration, data warehousing, big data analytics, deployment process automation, Fabric items provisioning, and more.

This document provides an overview of the API endpoints, authentication methods, and usage examples for the .NET SDK for Fabric REST API. The .NET SDK is a client library that simplifies communication with the Microsoft Fabric API service and handles serialization and error handling for you.

Installation via NuGet

To install the client library via NuGet:

• Search for Microsoft.Fabric.Api in the NuGet Library, or
• Type Install-Package Microsoft.Fabric.Api into the Package Manager Console.

Getting Started

1. Register your application

Register your application to use Microsoft Fabric API.

2. Authenticate for the Microsoft Fabric service

The Microsoft Fabric .NET Client Library supports the use of TokenCredential classes in the Azure.Identity library.

You can read more about available Credential classes at Azure Identity client library for .NET.

The recommended library for authenticating against Microsoft Identity (Azure AD) is MSAL.

For an example of how to acquire a Microsoft Entra token for Microsoft Fabric Service, see Microsoft Fabric API - get token.

3. Create a Microsoft Fabric client object with an authentication provider

An instance of the FabricClient class handles building requests, sending them to the Microsoft Fabric API, and processing the responses. To create a new instance of this class, you need to provide a instance of TokenCredential or the string representation of its underlying Microsoft Entra access token.

4. Make requests to Microsoft Fabric

Once you have completed authentication and have a FabricClient, you can begin to make calls to the service.

For example, to get a list of workspaces:

using Microsoft.Fabric.Api;

// Get the list of workspaces using the client
var workspaces = fabricClient.Core.Workspaces.ListWorkspaces().ToList();
Console.WriteLine("Number of workspaces: " + workspaces.Count);
foreach (var workspace in workspaces)
{
    Console.WriteLine($"Workspace: {workspace.DisplayName}, Capacity ID: {workspace.CapacityId}");
}

Documentation and resources

• Microsoft Fabric API documentation