Automatisieren von Variablenbibliotheken mithilfe von APIs

Sie können die Rest-APIs von Microsoft Fabric verwenden, um die Verwaltung von Variablenbibliotheken in der Anwendungslebenszyklusverwaltung (APPLICATION Lifecycle Management, ALM) vollständig zu automatisieren.

Wenn Sie die APIs als Teil Ihrer Lebenszyklusverwaltung verwenden, werden Berechtigungen für die Elementreferenz während der Git-Update- und Pipelinebereitstellung überprüft.

Voraussetzungen

Um die APIs zu verwenden, benötigen Sie Folgendes:

• Die gleichen Voraussetzungen wie für das Variablenbibliothekselement.
• Ein Microsoft Entra-Token für den Fabric-Dienst. Verwenden Sie das Token im Autorisierungsheader des API-Aufrufs. Informationen zum Abrufen eines Tokens finden Sie im Fabric-API-Schnellstarter.

APIs für variable Bibliotheken

Sie können die REST-APIs der Variablenbibliothek verwenden, um die folgenden Funktionen auszuführen:

• Erstellen Sie eine Variablebibliothek: Erstellen Sie eine Variablebibliothek im angegebenen Arbeitsbereich.
• Abrufen einer Variablenbibliothek: Abrufen von Eigenschaften einer Variablenbibliothek. Sie können auch den aktiven Wert abrufen, der mithilfe des VariableLibraryProperties Parameters festgelegt wurde.
• Aktualisieren einer Variablenbibliothek: Aktualisieren der Eigenschaften einer Variablenbibliothek. Sie können den aktiven Wert auch mithilfe des VariableLibraryProperties Parameters aktualisieren.
• Löschen einer Variablenbibliothek: Löschen Der angegebenen Variablenbibliothek.
• Listenvariablenbibliotheken: Listenvariablenbibliotheken im angegebenen Arbeitsbereich.
• Abrufen der Definition einer Variablenbibliothek: Abrufen der öffentlichen Definition einer Variablenbibliothek.
• Aktualisieren Sie die Definition einer Variablenbibliothek: Überschreiben Sie die Definition einer Variablenbibliothek.

Die REST-APIs der Variablenbibliothek unterstützen Dienstprinzipale.

Beispiele

Einige Beispiele für die Verwendung der APIs finden Sie in der REST-Dokumentation für jede API.

Eine Aufschlüsselung der Definitionsstruktur einer Variablenbibliothek finden Sie unter Variablenbibliotheksdefinition.

Überlegungen und Einschränkungen

Größeneinschränkungen

• Es können bis zu 1.000 Variablen und bis zu 1.000 Wertesätze vorhanden sein, sofern Sie beide Anforderungen erfüllen:

  • Die Gesamtanzahl der Zellen in den alternativen Wertsätzen ist kleiner als 10.000.
  • Die Größe des Elements überschreitet nicht 1 MB.

  Diese Anforderungen werden überprüft, wenn Sie Änderungen speichern.

• Das Hinweisfeld kann bis zu 2.048 Zeichen enthalten.

• Das Feld mit der Wertsatzbeschreibung kann bis zu 2.048 Zeichen enthalten.

Einschränkungen für alternative Wertesätze

• Alternative Wertesätze in einer Variablenbibliothek werden in der Reihenfolge angezeigt, in der Sie sie hinzugefügt haben. Derzeit können Sie sie nicht in der Benutzeroberfläche neu anordnen. Um die Reihenfolge zu ändern, bearbeiten Sie die JSON-Datei direkt.
• Der Name der einzelnen Wertesätze muss innerhalb einer Variablenbibliothek eindeutig sein.
• Variablennamen müssen innerhalb einer Variablenbibliothek eindeutig sein. Sie können zwei Variablen mit demselben Namen in einem Arbeitsbereich haben, wenn sie sich in verschiedenen Elementen befinden.
• Es gibt immer einen (und nur einen) aktiven Wert, der in einer Variablenbibliothek gleichzeitig festgelegt ist. Sie können einen Wertsatz nicht löschen, während er aktiv ist. Um ihn zu löschen, konfigurieren Sie zuerst einen anderen Wert, der als aktiv festgelegt ist. Sie können für jede Phase einer Bereitstellungspipeline einen anderen aktiven Wert festlegen.