Azure DevOps REST API：更新变量组变量及构建号自动递增问题

核心问题分析 #

你遇到的ArgumentNullException: variableGroupParameters错误，本质是PUT请求的Body结构不符合Azure DevOps API的要求，同时需要确认权限和实现逻辑的细节。下面分点解决你的三个疑问：

一、System.AccessToken的使用验证 #

你的令牌引用方式是对的，但需要补全权限配置：

• 进入Pipeline编辑页，点击右上角「...」→「Pipeline settings」→「Security」
• 找到「Build Service (你的组织名)」账户，确保它对目标变量组拥有编辑权限（默认只有读取权限，会导致更新失败）

二、修正请求体结构（解决核心错误） #

错误提示variableGroupParameters为空，是因为你额外添加了不需要的字段。普通变量组的更新请求不需要variableGroupProjectReferences和providerData（后者用于链接外部数据源如Key Vault）。修正后的脚本如下：

# 读取当前构建号并递增
$currentBuildNumber = [int]$(build_number)
$newBuildNumber = $currentBuildNumber + 1

# 构造认证头
$authHeader = @{Authorization = "Bearer $(System.AccessToken)"}

# 构造符合API要求的请求体
$body = @{
    description = "Build number"
    name = "BUILD_NUMBER_GROUP"
    type = "Vsts"
    variables = @{
        build_number = @{
            isSecret = $false
            isReadOnly = $false
            value = $newBuildNumber.ToString()
        }
    }
} | ConvertTo-Json -Depth 10

# 调用API更新变量组
Invoke-RestMethod -Uri "https://dev.azure.com/{organisation}/{project}/_apis/distributedtask/variablegroups/100?api-version=7.2-preview.2" `
    -Method Put `
    -Body $body `
    -Headers $authHeader `
    -ContentType "application/json"

三、实现思路的正确性确认 #

你的整体思路是可行的：读取变量组值→递增→API更新。补充几个关键注意点：

• 并发冲突：如果多个Pipeline同时触发，可能出现构建号重复。可以在更新前加校验逻辑，比如先重新读取变量组值，确认和之前读取的一致再更新
• API版本：使用7.2-preview.2或稳定版7.1都可以，确保URL中的变量组ID、组织名、项目名替换为实际值
• 变量引用：脚本中$(build_number)可以直接读取变量组中的值，前提是Pipeline已经关联了该变量组

测试步骤 #

1. 给Build Service账户配置变量组编辑权限
2. 替换脚本中的占位符（组织名、项目名、变量组ID）
3. 运行Pipeline，查看变量组的build_number是否成功递增

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