Sdílet prostřednictvím

Automatizace kanálu nasazení pomocí rozhraní FABRIC API

  • Článek

Nástroj kanálů nasazení Microsoft Fabric umožňuje týmům vytvářet efektivní a opakovaně použitelný proces vydávání obsahu prostředků infrastruktury.

Důležité

Tato funkce je ve verzi Preview.

Pomocí rozhraní REST API prostředků infrastruktury nasazení můžete integrovat prostředky infrastruktury do procesu automatizace vaší organizace. Tady je několik příkladů toho, co je možné provést pomocí rozhraní API:

  • Integrujte prostředky infrastruktury do známých nástrojů DevOps, jako jsou Azure DevOps nebo GitHub Actions.

  • Naplánujte automatické nasazení kanálů v určitém čase.

  • Současně nasaďte několik kanálů.

  • Kaskádová v závislosti na nasazení kanálu. Pokud máte obsah propojený mezi kanály, můžete se ujistit, že jsou některé kanály nasazené před ostatními.

Požadavky

Pokud chcete pracovat s rozhraními API kanálu nasazení, potřebujete následující požadavky:

  • Stejné požadavky musíte použít kanály nasazení.
  • Token Microsoft Entra pro službu Fabric. Tento token použijte v autorizační hlavičce volání rozhraní API. Informace o tom, jak získat token, najdete v rychlém startu s rozhraním API Fabric.

Rozhraní REST API můžete použít bez PowerShellu, ale skripty v tomto článku používají PowerShell. Pokud chcete skripty spustit, musíte nainstalovat následující programy:

Funkce rozhraní API kanálů nasazení

Rozhraní REST API kanálů nasazení umožňují provádět následující funkce:

  • Získání kanálu nasazení: Vrátí informace o zadaném kanálu nasazení.

  • Seznam kanálů nasazení: Vrátí seznam kanálů nasazení, ke kterým má uživatel přístup.

  • Získání fází kanálu nasazení: Vrátí fáze zadaného nasazení, včetně id, zobrazovaného názvu, popisu a toho, jestli je fáze veřejná nebo ne.

  • Získání položek fáze kanálu nasazení: Vrátí podporované položky z pracovního prostoru přiřazeného k zadané fázi zadaného kanálu nasazení.

  • Nasadit obsah fáze: Nasadí položky ze zadané fáze zadaného kanálu nasazení.

    • Pomocí tohoto rozhraní API můžete nasadit všechny položky nebo vybrat konkrétní položky, které chcete nasadit. Pokud nejsou vybrány žádné konkrétní položky, nasadí se všechny položky.

    • K vyhledání ID příslušné fáze pro nasazení použijte rozhraní API Get Deployment Pipelines Api.

    • Toto rozhraní API je integrované s rozhraními API dlouhotrvajících operací za účelem monitorování stavu nasazení.

      • Získejte stav operace, abyste zjistili, jestli je operace dokončená pomocí rozhraní API get Long Running – Get Operation State API.
      • Po dobu 24 hodin po dokončení nasazení jsou rozšířené informace o nasazení k dispozici v rozhraní API pro získání výsledku operace.

K dokončení souvisejících operací můžete použít také další volání rozhraní REST API infrastruktury.

Příklady PowerShellu

Následující skripty PowerShellu vám pomůžou pochopit, jak provádět několik procesů automatizace. Pokud chcete zobrazit nebo zkopírovat text v ukázce PowerShellu, použijte odkazy v této části.

  • Nasadit vše

    Zadejte následující údaje:

    • Název kanálu
    • Název zdrojové fáze
    • Název cílové fáze
    • Poznámky k nasazení (volitelné)

  • Selektivní nasazení

    Zadejte následující údaje:

    • Název kanálu
    • Název zdrojové fáze
    • Název cílové fáze
    • Položky k nasazení (zobrazovaný název a typ položky)
    • Poznámky k nasazení (volitelné)

Úvahy a omezení

Při používání rozhraní API kanálů nasazení zvažte následující omezení:

  • Všechna omezení, která platí pro kanál nasazení, platí při používání rozhraní API. Další informace najdete v tématu Osvědčené postupy pro kanály nasazení.

  • Toky dat se v současné době nepodporují. Zákazníci, kteří používají toky dat, můžou používat API Power BI.

  • Instanční objekty jsou podporované jenom pro položky Power BI.

  • V prostředcích infrastruktury nejsou dostupné všechny možnosti nasazení dostupné v API Power BI. V rozhraní API pro nasazení fáze nasazení nejsou dostupná následující rozhraní API:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Pokud potřebujete jedno z těchto rozhraní API, použijte k nasazení API Power BI. Tato rozhraní API ale fungují jenom pro položky Power BI.

Související obsah