Automatiser variabelbiblioteker ved hjælp af API'er

Du kan bruge Microsoft Fabric REST API'er til fuldt ud at automatisere administrationen af variable biblioteker i ALM (Application Lifecycle Management).

Hvis du bruger API'erne som en del af din livscyklusadministration, kontrolleres tilladelser til elementreference under Git-opdatering og pipelineudrulning.

Forudsætninger

Hvis du vil bruge API'erne, skal du bruge:

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

API'er til variabelbibliotek

Du kan bruge REST-API'er til variabelbiblioteket til at udføre følgende funktioner:

• Opret et variabelbibliotek: Opret et variabelbibliotek i det angivne arbejdsområde.
• Hent et variabelbibliotek: Hent egenskaber for et variabelbibliotek. Du kan også hente den aktive værdi, der er indstillet ved hjælp af parameteren VariableLibraryProperties .
• Opdater et variabelbibliotek: Opdater egenskaberne for et variabelbibliotek. Du kan også opdatere den aktive værdi, der er indstillet, ved hjælp af parameteren VariableLibraryProperties .
• Slet et variabelbibliotek: Slet det angivne variabelbibliotek.
• Vis variabelbiblioteker: Vis variabelbiblioteker i det angivne arbejdsområde.
• Hent definitionen af et variabelbibliotek: Hent den offentlige definition af et variabelbibliotek.
• Opdater definitionen af et variabelbibliotek: Tilsidesæt definitionen af et variabelbibliotek.

REST-API'er til variabelbiblioteket understøtter tjenesteprincipaler.

Eksempler

Du kan finde nogle eksempler på, hvordan du bruger API'erne, i REST-dokumentationen for hver API.

Du kan finde en oversigt over definitionsstrukturen for et variabelbibliotek under Definition af variabelbibliotek.

Overvejelser og begrænsninger

Størrelsesbegrænsninger

• Der kan være op til 1.000 variabler og op til 1.000 værdisæt, så længe du opfylder begge disse krav:

  • Det samlede antal celler i de alternative værdisæt er mindre end 10.000.
  • Varens størrelse overstiger ikke 1 MB.

  Disse krav valideres, når du gemmer ændringer.

• Notefeltet kan indeholde op til 2.048 tegn.

• Feltet beskrivelse af værdisættet kan indeholde op til 2.048 tegn.

Begrænsninger for alternative værdisæt

• Alternative værdisæt i et variabelbibliotek vises i den rækkefølge, du tilføjede dem i. I øjeblikket kan du ikke ændre rækkefølgen af dem i brugergrænsefladen. Hvis du vil ændre rækkefølgen, skal du redigere JSON-filen direkte.
• Navnet på hvert værdisæt skal være entydigt i et variabelbibliotek.
• Variabelnavne skal være entydige i et variabelbibliotek. Du kan have to variabler med samme navn i et arbejdsområde, hvis de er i forskellige elementer.
• Der er altid én (og kun én) aktiv værdi angivet i et variabelbibliotek ad gangen. Du kan ikke slette et værdisæt, mens det er aktivt. Hvis du vil slette den, skal du først konfigurere en anden værdi, der er indstillet til at være aktiv. Du kan have en anden aktiv værdi angivet for hver fase i en udrulningspipeline.