SuperAPI AI 工具集

git-integration-operations-cli

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:在 CLI 环境中自动化 Microsoft Fabric 的 Git 集成生命周期,包括连接、提交、更新、状态查询与断开连接。所有 Git 操作均为针对 https://api.fabric.microsoft.com 的控制平面调用。

主要能力:连接工作区到 Azure DevOps 或 GitHub;初始化连接(PreferWorkspace 或 PreferRemote);commitToGit 提交工作区项;updateFromGit 从 Git 更新;查询 git/status 同步状态;解决冲突;断开连接;将分支工作区链接到其基础工作区。

使用方式:优先使用 fab api(先执行 fab auth login,自动设置基础 URL 与 Fabric 令牌受众),az rest 作为回退(需自行传 --resource "https://api.fabric.microsoft.com",否则 401)。请求体通过 -i 传文件或内联 JSON,不可用 stdin。每次 api.fabric.microsoft.com 调用必须携带 x-ms-fabric-skill: git-integration-operations-cli 头(az rest 用 --headers "x-ms-fabric-skill=git-integration-operations-cli"),包括所有 LRO 轮询与重试。

关键限制:commitToGit、updateFromGit 甚至 git/status 可能返回 202 长时操作,需轮询操作直至 Succeeded,再读 git/status 确认 workspaceHead == remoteCommitHash。updateFromGit 需当前 workspaceHead,过期值返回 400 WorkspaceHeadMismatch。工作区必须已分配容量,调用者需具备相应角色(连接/断开需 Admin,提交/更新至少 Contributor)。同一工作区同一时间只能运行一个 Git 操作。GitHub 同步开关默认关闭,Azure DevOps 默认开启。目标 directoryName 必须已存在于分支上,否则 404 GitProviderResourceNotFound。GitHub 连接必须使用 PAT,无自动凭据模式。

适用场景:CI/CD 流水线、服务主体或托管标识驱动的无人值守自动化。

暂未提供:具体价格、平台支持范围等资料未说明。