通过API触发Azure DevOps Pipeline时如何指定目标分支？

你的脚本能成功触发Pipeline，但指定分支未生效，核心原因通常是JSON序列化不完整或分支名未正确传递，以下是具体修复方案：

1. 修复JSON序列化深度问题 #

PowerShell的ConvertTo-Json默认仅处理2层嵌套结构，而你的请求体嵌套层级超过2层，会导致refName等深层字段被截断，无法正确传递给API。需添加-Depth参数确保完整序列化：

} | ConvertTo-Json -Depth 10

（数值10足够覆盖绝大多数嵌套场景，可根据实际结构调整）

2. 确保分支名正确替换 #

如果targetBranch是变量，你当前的写法是将字符串"targetBranch"作为分支名，而非变量对应的值。需动态替换变量：

# 先定义目标分支变量
$targetBranch = "feature/your-branch"
# 在requestBody中引用变量
refName = "refs/heads/$targetBranch"

3. 验证JSON结构（可选） #

可临时添加输出语句，确认生成的JSON包含正确的分支信息：

Write-Host $requestBody

检查输出的JSON中，resources.repositories.self.refName是否为你期望的分支路径（如"refs/heads/feature/your-branch"）。

修改后的完整脚本示例 #

$apiUrl = "$organizationUrl/$project/_apis/pipelines/$definitionId/runs?api-version=7.1"
# 定义目标分支
$targetBranch = "your-target-branch-name"

$requestBody = @{
    resources = @{
        repositories = @{
            self = @{
                refName = "refs/heads/$targetBranch"
            }
        }
    }
    runResources = @{
        parameters = @{
            myVariable          = "myValue"
            myOtherVariable     = "someValue"
        }
    }
} | ConvertTo-Json -Depth 10

$headers = @{
    "Authorization" = "Basic " + [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$pat"))
    "Content-Type" = "application/json"
}

Invoke-RestMethod -Method Post -Uri $apiUrl -Headers $headers -Body $requestBody

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