Automatiza la canalización de implementación con las API de Fabric
La herramienta de canalizaciones de implementación de Microsoft Fabric permite a los equipos crear un proceso de versión eficaz y reutilizable para su contenido de Fabric.
Importante
Esta característica se encuentra en versión preliminar.
Usa las API de REST de Fabric de canalizaciones de implementación para integrar Fabric en el proceso de automatización de la organización. Estos son algunos ejemplos de lo que se puede hacer mediante las API:
Integrar Fabric en herramientas de DevOps conocidas, como Azure DevOps o Acciones de GitHub.
Programar implementaciones de canalización para que se produzcan automáticamente en un momento específico.
Implementar varias canalizaciones al mismo tiempo.
Aplicar en cascada en función de las implementaciones de canalización. Si tiene contenido conectado entre canalizaciones, puede asegurarse de que algunas canalizaciones se implementen antes que otras.
Requisitos previos
Para trabajar con las API de canalización de implementación, necesita los siguientes requisitos previos:
- Los mismos requisitos previos que necesita para usar canalizaciones de implementación.
- Un token de Microsoft Entra para el servicio Fabric. Usa ese token en el encabezado de autorización de la llamada API. Para obtener información sobre cómo obtener un token, consulta Inicio rápido de Fabric API.
Puedes usar las API de REST sin PowerShell, pero los scripts de este artículo usan PowerShell. Para ejecutar los scripts, debe instalar los siguientes programas:
Funciones de API de canalizaciones de implementación
Las API de REST de Fabric de canalizaciones de implementación permiten realizar las funciones siguientes:
Obtener canalización de implementación: devuelve información sobre la canalización de implementación especificada.
Enumerar canalizaciones de implementación: devuelve una lista de canalizaciones de implementación a las que el usuario tiene acceso.
Enumerar fases de canalización de implementación: devuelve las fases de la implementación especificada, incluido su identificador, nombre para mostrar, descripción y si la fase es pública o no.
Enumerar elementos de la fase de canalización de implementación: devuelve los elementos admitidos del área de trabajo asignada a la fase especificada de la canalización de implementación especificada.
Implementar contenido de fase: implementa elementos de la fase especificada de la canalización de implementación especificada.
Use esta API para implementar todos los elementos o para seleccionar elementos específicos que se van a implementar. Si no se selecciona ningún elemento específico, se implementan todos los elementos.
Para buscar el identificador de fase pertinente que se va a implementar, use la API Enumerar fases de canalización de implementación.
Esta API se integra con las API de operaciones de ejecución prolongada para supervisar el estado de implementación.
- Obtenga el estado de la operación para ver si la operación está completa con la API Obtener ejecución larga - Obtener estado de operación.
- Durante 24 horas después de completar la implementación, la información de implementación extendida está disponible en la API Obtener resultado de la operación.
También puede usar otras llamadas a la API REST de Fabric para completar las operaciones relacionadas.
Ejemplos de PowerShell
Puede usar los siguientes scripts de PowerShell para comprender cómo realizar varios procesos de automatización. Para ver o copiar el texto en un ejemplo de PowerShell, use los vínculos de esta sección.
-
Proporcione la siguiente información:
- Nombre de canalización
- Nombre de la fase de origen
- Nombre de la fase de destino
- Notas de implementación (opcional)
-
Proporcione la siguiente información:
- Nombre de canalización
- Nombre de la fase de origen
- Nombre de la fase de destino
- Elementos que se van a implementar (nombre para mostrar de elementos y tipo de elemento)
- Notas de implementación (opcional)
Consideraciones y limitaciones
Al usar las API de canalizaciones de implementación, tenga en cuenta las siguientes limitaciones:
Todas las limitaciones que se aplican a la canalización de implementación se aplican al usar las API. Para obtener más información, vea Procedimientos recomendados para las canalizaciones de implementación.
Los flujos de datos actualmente no se admiten. Los clientes que usan flujos de datos pueden usar las API de Power BI.
Las entidades de servicio solo se admiten para los elementos de Power BI.
No todas las opciones de implementación disponibles en las API de Power BI están disponibles en Fabric. Las siguientes API no están disponibles en la API de contenido de la fase de implementación de Fabric:
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Si necesita una de estas API, use la API de Power BI para implementar. Sin embargo, estas API solo funcionan para elementos de Power BI.