Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez utiliser les API REST Microsoft Fabric pour automatiser entièrement la gestion des bibliothèques de variables dans la gestion du cycle de vie des applications (ALM).
Si vous utilisez les API dans le cadre de votre gestion du cycle de vie, les autorisations de référence d’élément sont vérifiées pendant le déploiement de la mise à jour git et du pipeline.
Conditions préalables
Pour utiliser les API, vous avez besoin des éléments suivants :
- Les mêmes conditions préalables que pour l’élément de bibliothèque de variables.
- Jeton Microsoft Entra pour le service Fabric. Utilisez le jeton dans l’en-tête d’autorisation de l’appel d’API. Pour plus d’informations sur l’obtention d’un jeton, consultez Démarrage rapide avec l’API Fabric.
API de bibliothèque de variables
Vous pouvez utiliser les API REST de la bibliothèque de variables pour effectuer les fonctions suivantes :
- Créez une bibliothèque de variables : créez une bibliothèque de variables dans l’espace de travail spécifié.
-
Obtenir une bibliothèque de variables : récupérer les propriétés d’une bibliothèque de variables. Vous pouvez également récupérer la valeur active définie à l’aide du
VariableLibraryPropertiesparamètre. -
Mettre à jour une bibliothèque de variables : Mettez à jour les propriétés d’une bibliothèque de variables. Vous pouvez également mettre à jour la valeur active définie à l’aide du
VariableLibraryPropertiesparamètre. - Supprimez une bibliothèque de variables : supprimez la bibliothèque de variables spécifiée.
- Bibliothèques de variables de liste : répertorier les bibliothèques de variables dans l’espace de travail spécifié.
- Obtenir la définition d’une bibliothèque de variables : récupérez la définition publique d’une bibliothèque de variables.
- Mettez à jour la définition d’une bibliothèque de variables : remplacez la définition d’une bibliothèque de variables.
Les API REST de la bibliothèque de variables prennent en charge les principaux de service.
Exemples
Pour obtenir des exemples d’utilisation des API, consultez la documentation REST de chaque API.
Pour obtenir une répartition de la structure de définition d’une bibliothèque de variables, consultez la définition de la bibliothèque de variables.
Considérations et limitations
Limites de taille
Il peut y avoir jusqu’à 1 000 variables et jusqu’à 1 000 ensembles de valeurs, tant que vous répondez aux deux exigences suivantes :
- Le nombre total de cellules dans les jeux de valeurs alternatives est inférieur à 10 000.
- La taille de l’élément ne dépasse pas 1 Mo.
Ces exigences sont validées lorsque vous enregistrez les modifications.
Le champ de note peut contenir jusqu’à 2 048 caractères.
Le champ de description de l’ensemble de valeurs peut contenir jusqu’à 2 048 caractères.
Limitations pour les jeux de valeurs alternatifs
- Les autres jeux de valeurs d’une bibliothèque de variables apparaissent dans l’ordre dans lequel vous les avez ajoutés. Actuellement, vous ne pouvez pas les réorganiser dans l’interface utilisateur. Pour changer l’ordre, modifiez directement le fichier JSON.
- Le nom de chaque jeu de valeurs doit être unique dans une bibliothèque de variables.
- Les noms de variables doivent être uniques dans une bibliothèque de variables. Vous pouvez avoir deux variables portant le même nom dans un espace de travail si elles se trouvent dans des éléments différents.
- Il existe toujours une valeur active (et une seule) définie dans une bibliothèque de variables à la fois. Vous ne pouvez pas supprimer un jeu de valeurs lorsqu’il est actif. Pour le supprimer, configurez d’abord une autre valeur définie pour qu’elle soit active. Vous pouvez avoir un ensemble de valeurs actives différent pour chaque étape d’un pipeline de déploiement.