使用 Azure Devops API 创建生成定义

Question

我们正在尝试通过使用 Azure Devops Rest API 复制另一个构建定义信息来创建构建定义，但出现以下错误：

HttpError BadRequest - 值不能为空。参数名称： 定义.Repository.Mappings.Mapping.ServerPath。

这是我们正在遵循的步骤

1. 使用 API 获取构建信息 - 此步骤运行良好
2. 修改构建定义的名称
3. 通过传递上述构建定义请求正文创建新的构建定义

示例代码

var buildDefinitionGet = client.GetBuildDefinitionsAsync("XXX.DevOps", "15");

var newBuildDefinition = buildDefinitionGet;
newBuildDefinition.name = "MVC2017-1";

var buildDefinition = await client               
   .CreateBuildDefinitionsAsync("XXX.DevOps", newBuildDefinition)
   .ConfigureAwait(false);

这是请求正文结构：

public class BuildDefinitionRequestBody
{
    public Process process { get; set; }
    public Repository repository { get; set; }
    public ProcessParameters processParameters { get; set; }
    public List<object> drafts { get; set; }
    public Queue queue { get; set; }
    public string name { get; set; }
    public string type { get; set; }
    public string queueStatus { get; set; }
}

我们使用 TFVC 作为源代码控制。

我们有什么遗漏吗？

Answer 1

在这些场景中，有两种类型的错误，

“definition.Repository.Mappings.Mapping.ServerPath”和“definition.Repository.Mappings.Mapping.LocalPath”。

您路径中的以下情况将导致上述错误。

definition.Repository.Mappings.Mapping.LocalPath：

---

1. unc 路径不允许
2. 本地映射不允许是绝对路径或导航到 s 目录外
3. 两个映射不应具有相同的本地路径
4. 本地路径号为0或映射号为0

definition.Repository.Mappings.Mapping.ServerPath：

---

1. 不允许使用无效字符
2. 服务器路径或类型不允许有空字段
3. 两个映射不应具有相同的服务器路径

由于截图没有显示完整的本地路径和服务器路径，请根据上述规则检查路径。我建议你从页面顶部相应项目的代码 -> 文件中复制服务器路径值，这可以确保服务器路径正确。对于本地路径，我建议你一个一个删除，以确定是哪一个导致了这个问题。

用于克隆构建的 Powershell 等效代码。

$uri = 'https://dev.azure.com/{organization}/{project}/_apis/build/definitions/{definitionId}'

$result = Invoke-RestMethod -Method Get -Uri $uri -UseDefaultCredentials
$result.path = '\NewFolder\Location'
$result.name = "Testing"

$body = $result | ConvertTo-Json -Depth 7

Invoke-RestMethod -Method POST -uri 'https://dev.azure.com/{organization}/{project}/_apis/build/definitions?api-version=4.0' -UseDefaultCredentials -Body $body -ContentType 'application/json'

希望对你有帮助。