Automatización de bibliotecas de variables mediante API

Puede usar las API REST de Microsoft Fabric para automatizar completamente la administración de bibliotecas de variables en la administración del ciclo de vida de las aplicaciones (ALM).

Si usa las API como parte de la administración del ciclo de vida, los permisos para la referencia de elementos se comprueban durante la implementación de la canalización y la actualización de Git.

Prerrequisitos

Para usar las API, necesita:

• Los mismos requisitos previos que para el elemento de biblioteca de variables.
• Un token de Microsoft Entra para el servicio Fabric. Use el token en el encabezado de autorización de la llamada API. Para obtener información sobre cómo obtener un token, consulte Inicio rápido de Fabric API.

API de biblioteca de variables

Puede usar las API REST de la biblioteca de variables para realizar las funciones siguientes:

• Crear una biblioteca de variables: cree una biblioteca de variables en el área de trabajo especificada.
• Obtener una biblioteca de variables: recupere las propiedades de una biblioteca de variables. También puede recuperar el valor activo establecido mediante el VariableLibraryProperties parámetro .
• Actualizar una biblioteca de variables: actualice las propiedades de una biblioteca de variables. También puede actualizar el valor activo establecido mediante el VariableLibraryProperties parámetro .
• Eliminar una biblioteca de variables: elimine la biblioteca de variables especificada.
• Enumerar bibliotecas de variables: enumera las bibliotecas de variables en el área de trabajo especificada.
• Obtener la definición de una biblioteca de variables: recupere la definición pública de una biblioteca de variables.
• Actualizar la definición de una biblioteca de variables: invalide la definición de una biblioteca de variables.

Las API REST de la biblioteca de variables admiten entidades de servicio.

Ejemplos

Para obtener algunos ejemplos de cómo usar las API, consulte la documentación de REST para cada API.

Para obtener un desglose de la estructura de definición de una biblioteca de variables, consulte Definición de biblioteca de variables.

Consideraciones y limitaciones

Limitaciones de tamaño

• Puede haber hasta 1000 variables y hasta 1000 conjuntos de valores, siempre y cuando cumpla ambos requisitos:

  • El número total de celdas de los conjuntos de valores alternativos es inferior a 10 000.
  • El tamaño del elemento no supera los 1 MB.

  Estos requisitos se validan al guardar los cambios.

• El campo de nota puede tener hasta 2048 caracteres.

• El campo de descripción de value-set puede tener hasta 2048 caracteres.

Limitaciones para conjuntos de valores alternativos

• Los conjuntos de valores alternativos de una biblioteca de variables aparecen en el orden en que los agregó. Actualmente, no se pueden reordenar en la interfaz de usuario. Para cambiar el orden, edite el archivo JSON directamente.
• El nombre de cada conjunto de valores debe ser único dentro de una biblioteca de variables.
• Los nombres de variable deben ser únicos dentro de una biblioteca de variables. Puede tener dos variables con el mismo nombre en un área de trabajo si están en elementos diferentes.
• Siempre hay un valor activo (y solo uno) establecido en una biblioteca de variables a la vez. No se puede eliminar un conjunto de valores mientras está activo. Para eliminarlo, configure primero otro valor establecido para que esté activo. Puede tener un valor activo diferente establecido para cada fase de una canalización de implementación.