如何通过编程获取Azure DevOps环境的分支控制与防护配置？

要获取Azure DevOps环境的分支控制、审批等防护配置，不能仅依赖默认的环境详情API，需调用专门的检查配置API，具体步骤如下：

1. 调用检查配置API #

使用Azure DevOps的检查配置接口，可获取指定环境关联的所有防护规则，请求格式如下（替换占位符为实际值）：

GET https://dev.azure.com/{组织名称}/{项目名称}/_apis/pipelines/checks/configurations?resourceType=environment&resourceId={环境ID}&api-version=7.1-preview.1

2. 解析返回结果 #

该接口会返回所有类型的防护配置，关键信息解析：

• 分支控制规则：在返回项的settings字段中包含分支过滤逻辑，示例片段：

{
  "id": 456,
  "type": {
    "name": "Branch filter"
  },
  "settings": {
    "filterType": "include",
    "include": ["refs/heads/main", "refs/heads/release/*"],
    "exclude": ["refs/heads/feature/*"]
  },
  "resource": {
    "type": "environment",
    "id": "123"
  }
}

• 审批规则：返回项中会包含审批人/审批组信息，示例片段：

{
  "id": 789,
  "type": {
    "name": "Approvals"
  },
  "settings": {
    "approvers": [
      {
        "displayName": "张三",
        "id": "用户ID"
      }
    ]
  }
}

3. 权限说明 #

请求需使用具备环境读取或流水线读取权限的PAT令牌，确保能正常访问接口数据。

内容的提问来源于stack exchange，提问作者Roelof