azure-devops - 缺少用于策略的 Azure Devops REST API 文档？

Question

我们正在为我们的员工构建基于 Web 的自助服务，以加快/改善每个人的 DevOps 体验。自助服务使用 Azure Devops REST API，其中大部分工作正常，但当我即将实现分支策略时，我因缺乏文档(或无法找到它)而陷入困境。
我想我已经找到了可用于创建策略配置的文档，like this article .只是一般性地提到“设置”需要是一个 JObject，然后是针对各种场景的七个示例，但是如果有关于 14 种支持的策略类型的任何引用文章，那么我已经错过了。
我是瞎了眼还是微软只是懒得记录如何为不同类型的配置形成 JObjects？

Answer 1

Azure Devops REST API documentation for policies is missing?

对我来说，我更倾向于文档没有 明确指出 JObject的内容.
当我们检查 REST API 文档时 Configurations - Create ，我们可以得到以下信息:

事实上，它只是声明其类型是一个 JSON 对象，没有具体的内容或示例。
为了获取这个 JSON 对象的内容，我使用了 REST API Configurations - Get要获取响应正文的内容，我可以获得以下响应正文:

        "settings": {
            "minimumApproverCount": 2,
            "creatorVoteCounts": false,
            "allowDownvotes": false,
            "resetOnSourcePush": false,
            "requireVoteOnLastIteration": false,
            "resetRejectionsOnSourcePush": false,
            "blockLastPusherVote": false,
            "scope": [
                {
                    "refName": "refs/heads/Dev",
                    "matchKind": "Exact",
                    "repositoryId": "dcb40ef6-dae0-4e3c-b581-2f71c76e09a6"
                }
            ]
        },

因此，我们可以知道内容确实是一个 JSON 对象，并且由于我们设置的策略不同而有所不同。
现在，我们回到那个文档中的样本，我们会发现有很多这样的 settings ， 喜欢:
Approval count policy :

{
  "isEnabled": true,
  "isBlocking": false,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4906e5d171dd"
  },
  "settings": {
    "minimumApproverCount": 1,
    "creatorVoteCounts": false,
    "scope": [
      {
        "repositoryId": null,
        "refName": "refs/heads/master",
        "matchKind": "exact"
      }
    ]
  }
}

如果我们想设置任何其他支持的策略类型，我们可以在 UI 上手动设置，然后获取相应的响应正文。