Automatiser des bibliothèques de variables à l’aide d’API et d’Azure DevOps (préversion)

Vous pouvez utiliser les API REST Microsoft Fabric pour automatiser entièrement la gestion des bibliothèques de variables.

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 lors de la mise à jour Git et du déploiement du pipeline de déploiement.

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.
• Un 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

Les API REST de la bibliothèque de variables vous permettent d’effectuer les fonctions suivantes :

• Créer une bibliothèque de variables : créez une bibliothèque de variables dans l’espace de travail spécifié.
• Obtenir la bibliothèque de variables : récupérer les propriétés d’une bibliothèque de variables. Vous pouvez également récupérer le jeu de valeurs actives à l’aide du paramètre VariableLibraryProperties .
• Mettre à jour la bibliothèque de variables : Mettez à jour les propriétés d’une bibliothèque de variables. Vous pouvez également mettre à jour le jeu de valeurs actives à l’aide du paramètre VariableLibraryProperties .
• Supprimer la bibliothèque de variables : supprimez la bibliothèque de variables spécifiée.
• Lister les bibliothèques de variables dans l'espace de travail spécifié.
• Obtenir la définition de la bibliothèque de variables : récupérez la définition publique d’une bibliothèque de variables.
• Mettre à jour la définition de la bibliothèque de variables : remplacez la définition d’une bibliothèque de variables.

Les API REST de l’élément de bibliothèque de variables prennent en charge les principes de service.

Exemples

Pour obtenir des exemples d’utilisation des API, consultez la documentation de l’API REST pour chaque API. Pour obtenir une répartition de la structure de définition de la 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 le nombre total de cellules dans les ensembles de valeurs alternatifs est inférieur à 10 000 cellules et que la taille de l’élément ne dépasse pas 1 Mo. Cela est validé lorsque l’utilisateur enregistre les changements.
• 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 des ensembles de valeurs alternatifs

• Les ensembles de valeurs alternatifs de la bibliothèque de variables apparaissent dans l’ordre dans lequel ils ont été 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 ensemble de valeurs doit être unique dans la 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 différents éléments.
• Il y a toujours un et seulement un ensemble de valeurs actif dans une bibliothèque de variables à la fois. Vous ne pouvez pas supprimer l’ensemble de valeurs actif. Pour le supprimer, définissez d’abord un autre ensemble de valeurs comme actif. Vous pouvez définir un ensemble de valeurs actif différent pour chaque phase d’un pipeline de déploiement.