用途:通过 Fabric 控制平面 REST API 自动化 Fabric 应用生命周期管理(ALM),在部署管道的相邻阶段间(通常为开发→测试→生产)推进内容,覆盖管道/阶段生命周期、工作区分配与阶段间部署。
主要能力:创建、查询、更新、删除部署管道;管理 2–10 个有序阶段;为阶段分配或取消分配工作区;列出阶段项;执行阶段内容部署(异步 LRO,返回 202 后轮询 /v1/operations/{operationId});支持选择性部署(items 数组指定 sourceItemId 与 itemType);可查看操作与执行计划。
使用方式:基础地址为 https://api.fabric.microsoft.com/v1/deploymentPipelines,令牌受众须为 https://api.fabric.microsoft.com。所有 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: deployment-pipelines-authoring-cli(az rest 用 --headers "x-ms-fabric-skill=deployment-pipelines-authoring-cli"),包括每次 LRO 轮询与重试。按名称解析管道、阶段、工作区 ID 时,先列出再用 JMESPath 过滤,不得猜测 GUID。部署前可先列出阶段项预览。
适用场景:跨阶段推进 Fabric 内容、按需选择性部署、仅部署变更项(需自行比对定义,可用 references/scripts/diff_item_definitions.py 做本地差异,命令为 python references/scripts/diff_item_definitions.py source.json target.json)、修复项配对、审计部署。
限制:部署规则与参数规则仅能在门户 UI 配置,无 REST API;无“变更对比”API,lastDeploymentTime 不是可靠的变更信号;不支持的类型会被跳过;向后部署仅当目标阶段为空时可用;取消分配工作区会永久删除该阶段部署历史与规则;服务主体需管理员先启用其创建部署管道;主权云需从环境配置解析主机。所需权限与作用域(如 Pipeline.Deploy、Pipeline.ReadWrite.All、Workspace.ReadWrite.All)详见资料,缺失信息暂未提供。