Variabelenbibliotheken automatiseren met behulp van API's

U kunt de REST API's van Microsoft Fabric gebruiken om het beheer van variabelenbibliotheken in alm (Application Lifecycle Management) volledig te automatiseren.

Als u de API's gebruikt als onderdeel van het levenscyclusbeheer, worden machtigingen voor itemverwijzing gecontroleerd tijdens de implementatie van Git-updates en pijplijnen.

Vereiste voorwaarden

Als u de API's wilt gebruiken, hebt u het volgende nodig:

• Dezelfde vereisten als voor het variabele bibliotheekitem.
• Een Microsoft Entra-token voor de Fabric-service. Gebruik het token in de autorisatieheader van de API-aanroep. Zie Fabric API quickstart voor informatie over hoe je een token kunt verkrijgen.

API's voor variabele bibliotheken

U kunt de REST API's van de variabelebibliotheek gebruiken om de volgende functies uit te voeren:

• Een variabelebibliotheek maken: Maak een variabelebibliotheek in de opgegeven werkruimte.
• Een variabelebibliotheek ophalen: eigenschappen van een variabelebibliotheek ophalen. U kunt de ingestelde actieve waarde ook ophalen met behulp van de VariableLibraryProperties parameter.
• Een variabelebibliotheek bijwerken: werk de eigenschappen van een variabelebibliotheek bij. U kunt de ingestelde actieve waarde ook bijwerken met behulp van de VariableLibraryProperties parameter.
• Een variabelebibliotheek verwijderen: verwijder de opgegeven variabelebibliotheek.
• Lijst met variabelebibliotheken: Lijst met variabelenbibliotheken in de opgegeven werkruimte.
• Haal de definitie van een variabelebibliotheek op: haal de openbare definitie van een variabelebibliotheek op.
• De definitie van een variabelebibliotheek bijwerken: de definitie van een variabelebibliotheek overschrijven.

De REST API's van de variabele bibliotheek ondersteunen serviceprincipalen.

Voorbeelden

Zie de REST-documentatie voor elke API voor enkele voorbeelden van het gebruik van de API's.

Zie de definitie van de variabelebibliotheek voor een uitsplitsing van de structuur van de definitie van een variabelebibliotheek.

Overwegingen en beperkingen

Groottebeperkingen

• Er kunnen maximaal 1000 variabelen en maximaal 1000 waardensets zijn, zolang u aan beide vereisten voldoet:

  • Het totale aantal cellen in de alternatieve waardesets is kleiner dan 10.000.
  • De grootte van het item is niet groter dan 1 MB.

  Deze vereisten worden gevalideerd wanneer u wijzigingen opslaat.

• Het notitieveld mag maximaal 2048 tekens bevatten.

• Het beschrijvingsveld van de waardeset mag maximaal 2048 tekens bevatten.

Beperkingen voor alternatieve waardesets

• Alternatieve waardesets in een variabelebibliotheek worden weergegeven in de volgorde waarin u ze hebt toegevoegd. Op dit moment kunt u ze niet opnieuw ordenen in de gebruikersinterface. Als u de volgorde wilt wijzigen, bewerkt u het JSON-bestand rechtstreeks.
• De naam van elke waardeset moet uniek zijn binnen een variabelebibliotheek.
• Namen van variabelen moeten uniek zijn binnen een variabelebibliotheek. U kunt twee variabelen met dezelfde naam in een werkruimte hebben als ze zich in verschillende items bevinden.
• Er is altijd één (en slechts één) actieve waarde die is ingesteld in een variabele bibliotheek tegelijk. U kunt een waardeset niet verwijderen terwijl deze actief is. Als u deze wilt verwijderen, configureert u eerst een andere waarde die is ingesteld op actief. U kunt voor elke fase van een implementatiepijplijn een andere actieve waarde instellen.