Automate your deployment pipeline with Fabric APIs

The Microsoft Fabric deployment pipelines tool enables teams to build an efficient and reusable release process for their Fabric content.

Important

This feature is in preview.

Use the deployment pipelines Fabric REST APIs to integrate Fabric into your organization's automation process. Here are a few examples of what can be done by using the APIs:

  • Integrate Fabric into familiar DevOps tools such as Azure DevOps or GitHub Actions.

  • Schedule pipeline deployments to happen automatically at a specific time.

  • Deploy multiple pipelines at the same time.

  • Cascade depending on pipeline deployments. If you have content connected across pipelines, you can make sure some pipelines are deployed before others.

Prerequisites

To work with deployment pipeline APIs, you need the following prerequisites:

You can use the REST APIs without PowerShell, but the scripts in this article use PowerShell. To run the scripts, you need to install the following programs:

Deployment pipelines API functions

The deployment pipelines Fabric REST APIs allow you to perform the following functions:

You can also use other Fabric REST API calls, to complete related operations.

PowerShell examples

You can use the following PowerShell scripts to understand how to perform several automation processes. To view or copy the text in a PowerShell sample, use the links in this section.

  • Deploy all

    Provide the following information:

    • Pipeline name
    • Source stage name
    • Target stage name
    • Deployment notes (optional)
  • Selective deploy

    Provide the following information:

    • Pipeline name
    • Source stage name
    • Target stage name
    • Items to deploy (items display name and item type)
    • Deployment notes (optional)

Considerations and limitations

When using the deployment pipelines APIs, consider the following limitations:

  • All limitations that apply for deployment pipeline, apply when using the APIs. For more information, see Deployment pipelines best practices.

  • Dataflows are currently not supported. Customers using dataflows can use the Power BI APIs.

  • Service principals are only supported for Power BI items.

  • Not all deployment options available in the Power BI APIs are available in Fabric. The following APIs aren't available in Fabric's Deploy stage content API:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    If you need one of these APIs, use the Power BI API to deploy. However, these APIs only work for Power BI items.