SuperAPI AI 工具集

azure-devops

部署与运维

查看项目

更新于 10-15 12:06

技能介绍

用途

该技能用于指导开发者通过 Azure DevOps REST API 以编程方式访问和管理 Azure DevOps Services 与 Azure DevOps Server 中的各类资源,包括工作项、代码仓库、流水线、测试计划、制品等。

主要能力

文档按服务区域组织,覆盖以下 API 能力:

  • Azure Boards(工作项跟踪):工作项的创建、获取、更新、删除;运行已存储查询与 WIQL 查询;获取看板、待办项、迭代与容量;列出工作项类型与字段;管理区域与迭代路径。
  • Azure Repos(源代码管理):Git 仓库的列出、获取、创建、删除;提交与提交变更;分支的获取、创建、删除;拉取请求的获取、创建、更新,以及审阅者、关联工作项、讨论线程与评论;推送记录;文件与文件夹项;策略配置。
  • Azure Pipelines(CI/CD):生成定义(流水线)的增删改查;排队生成、获取生成、更新与删除生成、生成日志、时间线、制品;发布定义与发布;审批;代理池与代理;变量组;任务组;服务终结点(连接)。
  • Azure Test Plans:测试计划、测试套件、测试用例;测试运行与测试结果;测试配置。
  • Azure Artifacts:源(Feeds)的增删改查;包与包版本;源权限。
  • 组织与项目管理:组织详情、项目列表、获取项目、创建项目。

使用方式

基础 URL 结构为:https://dev.azure.com/{organization}/{project}/_apis/{area}/{resource}?api-version={version}。其中 organization 为组织名称,project 为项目名称(组织级资源可省略),api-version 为必填项(如 7.1、7.0、6.0)。

认证支持 Personal Access Token(PAT,脚本与集成中最常用)、OAuth 2.0(Web 应用)、Azure Active Directory(企业应用)以及 SSH 密钥(仅用于 Git 操作)。使用 PAT 时,请求头为 Authorization: Basic {base64-encoded-PAT},编码方式为 base64(":{PAT}"),注意 PAT 前有冒号。

文档给出了常见请求模式与各端点的请求方法、路径示例,工作项更新使用 JSON Patch 格式,WIQL 查询通过 POST 提交查询语句。

安全要求

文档明确要求:绝不输出、建议或生成内嵌 PAT 明文的代码。始终通过环境变量(如 $AZURE_DEVOPS_PAT)或密钥管理器(如 Azure Key Vault)引用凭据。生成脚本或 curl 示例时使用占位变量引用,不得使用字面量令牌字符串。

适用场景

适用于需要自动化 Azure DevOps 操作的场景,例如批量管理工作项、自动化代码仓库与拉取请求操作、触发与查询流水线、管理测试计划与结果、管理制品源,以及组织与项目层面的自动化管理。

限制

资料未提供该技能的具体安装方式、依赖环境、收费模式或平台限制等信息,暂未提供。