Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Puede usar las API rest de Microsoft Fabric para automatizar completamente la administración de bibliotecas de variables.
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 de implementación y actualización de Git.
Prerrequisitos
Para usar las API, necesita:
- Los mismos requisitos previos que para el elemento biblioteca variable.
- 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
La API REST de la biblioteca de variables permite realizar las siguientes funciones:
- Crear biblioteca de variables: cree una biblioteca de variables en el área de trabajo especificada.
- Obtener biblioteca de variables: recupere las propiedades de una biblioteca de variables. También puede recuperar el valor activo establecido mediante el parámetro VariableLibraryProperties .
- Actualizar biblioteca de variables: actualice las propiedades de una biblioteca de variables. También puede actualizar el valor activo establecido mediante el parámetro VariableLibraryProperties .
- Eliminar 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 definición de biblioteca de variables: recupere la definición pública de una biblioteca de variables.
- Actualizar definición de biblioteca de variables: invalide la definición de una biblioteca de variables.
Las API REST de elemento de biblioteca variable admiten principios de servicio.
Ejemplos
Para obtener algunos ejemplos de cómo usar las API, consulte la documentación de la API REST para cada API. Para obtener un desglose de la estructura de definición de la biblioteca de variables, consulte la definición de la biblioteca de variables.
Consideraciones y limitaciones
Limitaciones de tamaño
- Puede haber hasta 1000 variables y hasta 1000 conjuntos de valores, siempre y cuando el número total de celdas de los conjuntos de valores alternativos sea inferior a 10 000 celdas y el tamaño del elemento no sea mayor que 1 MB. Esto se valida cuando el usuario guarda 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 del conjunto de valores alternativos
- Los conjuntos de valores alternativos de la Biblioteca de variables aparecen en el orden en que se agregaron. 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 la 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 uno y solo un conjunto de valores activo en una Biblioteca de variables a la vez. No se puede eliminar el conjunto de valores activo. Para eliminarlo, establezca primero otro conjunto de valores que sea activo. Puede configurar un conjunto de valores activado diferente para cada fase de un proceso de implementación.