Microsoft Fabric 部署管道 工具使团队能够为其 Fabric 内容构建高效且可重用的发布过程。
使用 部署管道 Fabric REST API 接口，将 Fabric 集成到您的组织自动化流程中。 下面是可以使用 API 完成的几个示例：
将 Fabric 集成到熟悉的 DevOps 工具中，如 Azure DevOps 或 GitHub Actions。
安排管道部署在特定时间自动进行。
同时部署多个管道。
级联取决于管道部署。 如果跨管道连接了内容，则可以确保在其他管道之前部署一些管道。
先决条件
若要使用部署管道 API，需要满足以下先决条件：
- 使用部署管道所需的相同先决条件。
- Fabric 服务的 Microsoft Entra 令牌。 该令牌将在 API 调用的授权标头中使用。 有关如何获取令牌的信息，请参阅 Fabric API 快速入门。
可以在不使用 PowerShell 的情况下使用 REST API，不过本文中的脚本使用了 PowerShell。 若要运行脚本，需要安装以下程序：
部署管道 API 函数
部署管道 Fabric REST API 允许你执行以下功能：
获取部署管道：返回有关指定部署管道的信息。
列出部署管道：返回用户有权访问的部署管道列表。
列出部署管道阶段：返回指定部署的各个阶段，包括其 ID、显示名称、说明以及该阶段是否为公共阶段。
列出部署管道阶段项：返回分配给指定部署管道指定阶段的工作区中的支持项。
部署阶段内容：从指定部署管道的指定阶段部署项。
使用此 API 部署所有项或选择要部署的特定项。 如果未选择特定项，则将部署所有项。
若要查找要部署的相关阶段 ID，请使用 列表部署管道阶段 API。
此 API 与 长时间运行操作 API 集成，用以监控部署状态。
- 获取操作状态，以查看操作是否已通过“获取长时间运行 - 获取操作状态 API”完成。
- 部署完成后 24 小时，扩展部署信息可在“获取作结果 API”中获取。
创建部署管道：创建部署管道。
删除部署管道：删除部署管道。
更新部署管道：更新部署管道。
获取部署管道阶段：获取部署管道阶段的详细信息。
更新部署管道阶段：更新部署管道阶段。
添加部署管道角色分配：向部署管道添加角色分配。
删除部署管道角色分配：从部署管道中删除角色分配。
列出部署管道角色分配：列出部署管道的所有角色分配。
将工作区分配到部署管道阶段：将工作区分配到特定的部署管道阶段。
从部署管道阶段取消分配工作区：从特定部署管道阶段取消分配工作区。
获取部署管道操作：获取部署管道操作的详细信息。
列出部署管道操作：列出部署管道的所有操作。
还可以使用其他 Fabric REST API 调用来完成相关操作。
PowerShell 示例
可以通过下面的 PowerShell 脚本来了解如何执行多个自动化过程。 若要在 PowerShell 示例中查看或复制文本，请使用本部分中的链接。
还可以下载整个 Fabric-Samples GitHub 文件夹。
-
提供以下信息：
- 管道名称
- 源阶段名称
- 目标阶段名称
- 部署说明（可选）
- 主体类型。 选择 UserPrincipal 或 ServicePrincipal。 如果是服务主体，请同时提供：
- 服务主体的应用程序（客户端）ID
- 服务主体的目录（租户）ID
- 服务主体的机密值
-
提供以下信息：
- 管道名称
- 源阶段名称
- 目标阶段名称
- 要部署的项（项显示名称和项目类型）
- 部署说明（可选）
- 主体类型。 选择 UserPrincipal 或 ServicePrincipal。 如果是服务主体，还请提供：
- 服务主体的应用程序（客户端）ID
- 服务主体的目录（租户）ID
- 服务主体的机密值
-
提供以下信息：
- 开发工作区 ID
- 新的生产工作区名称
- 管道名称
- 部署说明（可选）
- 主体类型。 选择 UserPrincipal 或 ServicePrincipal。 如果是服务主体，还请提供：
- 服务主体的应用程序（客户端）ID
- 服务主体的目录（租户）ID
- 服务主体的机密值
注意事项和限制
使用部署管道 API 时，请考虑下面的限制：
适用于部署管道的所有限制都在使用 API 时适用。 有关详细信息，请参阅 部署管道最佳做法。
目前不支持数据流。 使用数据流的客户可以使用 Power BI API。
并非 Power BI API 中可用的所有部署选项都可以在 Fabric 中使用。 Fabric 的部署阶段内容 API 中 不提供 以下 API：
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
若要使用其中一个 API，请使用 Power BI API 进行部署。 但是，这些 API 仅适用于 Power BI 项。