Dela via

Automatisera din distributionspipeline med Infrastruktur-API:er

  • Artikel

Med distributionspipelines-verktyget för Microsoft Fabric kan teamen skapa en effektiv och återanvändbar lanseringsprocess för sitt Fabric-innehåll.

Viktigt!

Den här funktionen är i förhandsversion.

Använd REST API:er för infrastrukturresurser för distributionspipelines för att integrera Infrastruktur i organisationens automatiseringsprocess. Här följer några exempel på vad som kan göras med hjälp av API:erna:

  • Integrera Fabric i välbekanta DevOps-verktyg som Azure DevOps eller GitHub Actions.

  • Schemalägg pipelinedistributioner så att de sker automatiskt vid en viss tidpunkt.

  • Distribuera flera pipelines samtidigt.

  • Kaskad beroende på pipelinedistributioner. Om du har innehåll som är anslutet mellan pipelines kan du se till att vissa pipelines distribueras före andra.

Förutsättningar

För att arbeta med API:er för distributionspipeline behöver du följande krav:

Du kan använda REST-API:er utan PowerShell, men skripten i den här artikeln använder PowerShell. Om du vill köra skripten måste du installera följande program:

API-funktioner för distributionspipelines

Med rest-API: erna för distributionspipelines kan du utföra följande funktioner:

  • Hämta distributionspipeline: Returnerar information om den angivna distributionspipelinen.

  • Lista distributionspipelines: Returnerar en lista över distributionspipelines som användaren har åtkomst till.

  • Pipelinefaser för listdistribution: Returnerar stegen i den angivna distributionen, inklusive dess ID, visningsnamn, beskrivning och om fasen är offentlig eller inte.

  • Listdistributionspipelinesteg: Returnerar de objekt som stöds från arbetsytan som tilldelats den angivna fasen i den angivna distributionspipelinen.

  • Distribuera fasinnehåll: Distribuerar objekt från den angivna fasen i den angivna distributionspipelinen.

    • Använd det här API:et för att distribuera alla objekt eller för att välja specifika objekt som ska distribueras. Om inga specifika objekt har valts distribueras alla objekt.

    • Om du vill hitta det relevanta steg-ID:t som ska distribueras använder du API:et För pipelinesteg för listdistribution.

    • Det här API:et är integrerat med API:erna för långvariga åtgärder för att övervaka distributionsstatusen.

Du kan också använda andra REST API-anrop för infrastrukturresurser för att slutföra relaterade åtgärder.

PowerShell-exempel

Du kan använda följande PowerShell-skript för att förstå hur du utför flera automatiseringsprocesser. Om du vill visa eller kopiera texten i ett PowerShell-exempel använder du länkarna i det här avsnittet.

  • Distribuera alla

    Tillhandahåll följande information:

    • Pipelinenamn
    • Namn på källsteg
    • Målfasnamn
    • Distributionsanteckningar (valfritt)

  • Selektiv distribution

    Tillhandahåll följande information:

    • Pipelinenamn
    • Namn på källsteg
    • Målfasnamn
    • Objekt som ska distribueras (objektens visningsnamn och objekttyp)
    • Distributionsanteckningar (valfritt)

Beaktanden och begränsningar

När du använder API:erna för distributionspipelines bör du överväga följande begränsningar:

  • Alla begränsningar som gäller för distributionspipelinen gäller när du använder API:erna. Mer information finns i Metodtips för distributionspipelines.

  • Dataflöden stöds för närvarande inte. Kunder som använder dataflöden kan använda Power BI-API.

  • Tjänstens huvudnamn stöds endast för Power BI-objekt.

  • Alla distributionsalternativ som är tillgängliga i Power BI-API är inte tillgängliga i Infrastrukturresurser. Följande API:er är inte tillgängliga i Fabrics API för distributionsstegsinnehåll:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Om du behöver något av dessa API:er använder du Power BI-API för att distribuera. Dessa API:er fungerar dock bara för Power BI-objekt.

Relaterat innehåll