使用 Fabric API 將部署管線自動化

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。 若要執行指令碼，您必須安裝下列程式：

• PowerShell
• Azure PowerShell Az 模組

部署管線 API 函式

部署管線 Fabric REST API 可讓您執行下列函式：

• 取得部署管線：傳回指定部署管線的相關資訊。

• 列出部署管線：傳回使用者可存取的部署管線清單。

• 取得部署管線階段：傳回指定部署的階段，包括其 ID、顯示名稱、描述，以及階段是否為公用。

• 取得部署管線階段項目：從指派給指定部署管線之指定階段的工作區，傳回支援的項目。

• 部署階段內容：從指定部署管線的指定階段部署項目。

  • 使用此 API 部署所有項目，或選取要部署的特定項目。 若未選取任何特定項目，則會部署所有項目。

  • 若要尋找要部署的相關階段 ID，請使用取得部署管線階段 API。

  • 此 API 會與 長時間執行的作業 API 整合，以監視部署狀態。

    • 取得作業狀態，查看作業是否已使用取得長時間執行 – 取得作業狀態 API 來完成。
    • 部署完成後 24 小時，即可在取得作業結果 API 中取得延伸部署資訊。

您也可以使用其他 Fabric REST API 呼叫完成相關作業。

PowerShell 範例

您可以使用下列 PowerShell 指令碼來了解如何執行數個自動化程序。 若要檢視或複製 PowerShell 範例中的文字，請使用本節中的連結。

• 全部部署

  提供下列資訊：

  • 管線名稱
  • 來源階段名稱
  • 目標階段名稱
  • 部署注意事項 (選用)

• 選擇性部署

  提供下列資訊：

  • 管線名稱
  • 來源階段名稱
  • 目標階段名稱
  • 要部署的項目 (項目顯示名稱和項目類型)
  • 部署注意事項 (選用)

考量與限制

使用部署管線 API 時，請考量下列限制：

• 所有適用於部署管線的限制，皆會在使用 API 時適用。 如需詳細資訊，請參閱＜部署管線最佳做法＞。

• 目前不支援資料流程。 使用資料流程的客戶可以使用 Power BI API。

• 服務主體僅支援 Power BI 項目。

• 並非所有在 Power BI API 中可用的部署選項，皆可在 Fabric 中使用。 在 Fabric 的部署階段內容 API 中無法使用下列 API：

  • allowPurgeData
  • allowTakeOver
  • allowSkipTilesWithMissingPrerequisites

  若您需要其中一個 API，請使用 Power BI API 來部署。 不過，這些 API 僅適用於 Power BI 項目。

相關內容

• 開始使用部署管線
• 部署管線最佳做法
• 部署管線疑難排解