Del via

Automatiser din udrulningspipeline med Fabric API'er

  • Artikel

Microsoft Fabric-udrulningspipelines gør det muligt for teams at opbygge en effektiv og genbrugelig udgivelsesproces for deres Fabric-indhold.

Vigtigt

Denne funktion er en prøveversion.

Brug udrulningspipelines Fabric REST API'er til at integrere Fabric i organisationens automatiseringsproces. Her er nogle eksempler på, hvad der kan gøres ved hjælp af API'erne:

  • Integrer Fabric i velkendte DevOps-værktøjer, f.eks. Azure DevOps eller GitHub Actions.

  • Planlæg udrulninger af pipelines automatisk på et bestemt tidspunkt.

  • Udrul flere pipelines på samme tid.

  • Overlappet afhængigt af pipelineudrulninger. Hvis du har forbindelse til indhold på tværs af pipelines, kan du sikre dig, at nogle pipelines udrulles før andre.

Forudsætninger

Hvis du vil arbejde med API'er til udrulningspipelines, skal du have følgende forudsætninger:

Du kan bruge REST API'erne uden PowerShell, men scripts i denne artikel bruger PowerShell. Hvis du vil køre scripts, skal du installere følgende programmer:

API-funktioner til udrulningspipelines

Udrulningspipelines Fabric REST API'er giver dig mulighed for at udføre følgende funktioner:

  • Hent udrulningspipeline: Returnerer oplysninger om den angivne udrulningspipeline.

  • Listeinstallationspipelines: Returnerer en liste over udrulningspipelines, som brugeren har adgang til.

  • Faser i listeinstallationspipeline: Returnerer faserne i den angivne installation, herunder dens id, vist navn, beskrivelse, og om fasen er offentlig eller ej.

  • Elementer i fase for udrulningspipeline: Returnerer de understøttede elementer fra det arbejdsområde, der er tildelt til den angivne fase i den angivne udrulningspipeline.

  • Indhold af installationsfase: Installerer elementer fra den angivne fase i den angivne udrulningspipeline.

    • Brug denne API til at installere alle elementer eller til at vælge bestemte elementer, der skal installeres. Hvis der ikke er valgt nogen bestemte elementer, installeres alle elementer.

    • Hvis du vil finde det relevante fase-id, der skal udrulles, skal du bruge API'en Til fasefaser for listeinstallation.

    • Denne API er integreret med API'erne til long running operations for at overvåge installationsstatus.

Du kan også bruge andre Fabric REST API-kald til at fuldføre relaterede handlinger.

PowerShell-eksempler

Du kan bruge følgende PowerShell-scripts til at forstå, hvordan du udfører flere automatiseringsprocesser. Hvis du vil have vist eller kopiere teksten i et PowerShell-eksempel, skal du bruge linkene i dette afsnit.

  • Udrul alle

    Angiv følgende oplysninger:

    • Pipelinenavn
    • Navn på kildefase
    • Navn på destinationsfase
    • Installationsbemærkninger (valgfrit)

  • Selektiv installation

    Angiv følgende oplysninger:

    • Pipelinenavn
    • Navn på kildefase
    • Navn på destinationsfase
    • Elementer, der skal installeres (elementers viste navn og elementtype)
    • Installationsbemærkninger (valgfrit)

Overvejelser og begrænsninger

Når du bruger API'erne til udrulningspipelines, skal du overveje følgende begrænsninger:

  • Alle begrænsninger, der gælder for udrulningspipeline, gælder, når API'erne bruges. Du kan få flere oplysninger under Bedste praksis for udrulningspipelines.

  • Dataflow understøttes ikke i øjeblikket. Kunder, der bruger dataflow, kan bruge Power BI-API s.

  • Tjenesteprincipaler understøttes kun for Power BI-elementer.

  • Det er ikke alle udrulningsindstillinger, der er tilgængelige i Power BI-API s, der er tilgængelige i Fabric. Følgende API'er er ikke tilgængelige i Indholds-API'en til udrulningsfasen for Fabric:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Hvis du har brug for en af disse API'er, skal du bruge Power BI-API til at udrulle. Disse API'er fungerer dog kun for Power BI-elementer.

Relateret indhold