如何获取Azure DevOps REST API策略POST请求的请求体结构?
获取Azure DevOps策略配置请求体模板的方法
作为Azure REST API新手,你可以通过以下几种方式获取策略配置的正确请求体模板:
查看官方REST API文档的请求体示例
你参考的Policy Configurations - Create接口文档中,切换到中文版本后,会明确列出不同策略类型对应的请求体结构。比如你示例中的多审批者拉取请求策略,文档里会详细说明isEnabled(是否启用)、isBlocking(是否阻止合并)、type.id(即你通过GET /_apis/policy/types拿到的策略类型ID)、settings下各参数的含义与必填要求,同时会给出完整的JSON请求示例,你只需替换其中的组织、项目、仓库ID、分支名等实际参数即可使用。通过Azure DevOps UI导出现有策略配置
如果你已经在项目里配置过同类策略,可以直接从UI导出模板:- 进入项目的「项目设置」→「策略」页面
- 找到已配置的目标策略,点击「编辑」
- 打开浏览器开发者工具(按F12),切换到「网络」标签
- 点击页面上的「保存」按钮,捕获到的PUT请求里的请求体就是现成的模板,复制后修改参数就能复用
调用单个策略类型的详情接口获取配置Schema
除了获取策略类型列表,还可以调用单个策略类型的详情接口,获取该类型的配置Schema,明确每个参数的格式要求:GET https://dev.azure.com/organization/project/_apis/policy/types/{policyTypeId}?api-version=7.0返回结果中的
settingsSchema字段包含JSON Schema定义,会告诉你settings里每个参数的类型、取值范围等,比如minimumApproverCount是整数类型,scope是数组类型等。
内容的提问来源于stack exchange,提问作者Klára Janstová
相关产品推荐
相关产品推荐

