Automatiser din udrulningspipeline med Fabric API'er

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

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:

• De samme forudsætninger, du skal bruge for at bruge udrulningspipelines.
• Et Microsoft Entra-token til Fabric-tjenesten. Brug dette token i godkendelsesheaderen for API-kaldet. Du kan få oplysninger om, hvordan du får et token, under Hurtig start af Fabric API.

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:

• PowerShell
• Azure PowerShell Az-modul

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.

    • Hent handlingstilstanden for at se, om handlingen er fuldført med API'en Get Long Running - Get Operation.
    • I 24 timer efter udrulningen er fuldført, er de udvidede udrulningsoplysninger tilgængelige i API'enGet Operation Result .

• Opret udrulningspipeline: Opret en udrulningspipeline.

• Slet udrulningspipeline: Slet en udrulningspipeline.

• Opdater udrulningspipeline: Opdater en udrulningspipeline.

• Hent udrulningspipelinefase: Få oplysninger om en fase i udrulningspipelinen.

• Opdater fasen for udrulningspipeline: Opdater en fase i en udrulningspipeline.

• Tilføj rolletildeling for udrulningspipeline: Føj en rolletildeling til en udrulningspipeline.

• Slet rolletildeling for udrulningspipeline: Slet en rolletildeling fra en udrulningspipeline.

• Angiv rolletildelinger for udrulningspipeline: Vis alle rolletildelinger for en udrulningspipeline.

• Tildel arbejdsområde til udrulningspipelinefase: Tildel et arbejdsområde til en bestemt fase i udrulningspipelinen.

• Fjern tildeling af arbejdsområde fra fasen med udrulningspipeline: Fjern tildelingen af et arbejdsområde fra en bestemt fase i udrulningspipelinen.

• Hent udrulningspipelinehandling: Få oplysninger om en udrulningspipelinehandling.

• Angiv udrulningspipelinehandlinger: Angiv alle handlinger for en udrulningspipeline.

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.

Du kan også downloade hele Fabric-Samples GitHub-mappen.

• Udrul alle

  Angiv følgende oplysninger:

  • Pipelinenavn
  • Navn på kildefase
  • Navn på destinationsfase
  • Installationsbemærkninger (valgfrit)
  • Hovedtype. Vælg enten UserPrincipal eller ServicePrincipal. Hvis tjenesteprincipalen også skal levere:
    • Program-id (klient) for tjenesteprincipalen
    • Mappe-id (lejer) for tjenesteprincipalen
    • Tjenesteprincipalens hemmelige værdi

• 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)
  • Hovedtype. Vælg enten UserPrincipal eller ServicePrincipal. Hvis tjenesteprincipalen også skal levere:
    • Program-id (klient) for tjenesteprincipalen
    • Mappe-id (lejer) for tjenesteprincipalen
    • Tjenesteprincipalens hemmelige værdi

• Tildel til ny udrulningspipeline, og udrul

  Angiv følgende oplysninger:

  • Id for udviklingsarbejdsområde
  • Navn på nyt produktionsarbejdsområde
  • Pipelinenavn
  • Installationsbemærkninger (valgfrit)
  • Hovedtype. Vælg enten UserPrincipal eller ServicePrincipal. Hvis tjenesteprincipalen også skal levere:
    • Program-id (klient) for tjenesteprincipalen
    • Mappe-id (lejer) for tjenesteprincipalen
    • Tjenesteprincipalens hemmelige værdi

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.

• 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 vil bruge en af disse API'er, skal du bruge Power BI-API'en til at installere. Disse API'er fungerer dog kun for Power BI-elementer.

Relateret indhold

• Kom i gang med udrulningspipelines
• Bedste fremgangsmåder for udrulningspipelines
• Fejlfinding af udrulningspipelines