咨询VSTS变量组变量更新API：PUT请求提示不支持该方法

AI 小北

2026-5-21

如何通过API更新Azure DevOps变量组中的变量

当然存在更新变量组的API，但你之前的请求有两个关键问题：HTTP方法错误以及URL缺少变量组ID。我来帮你梳理正确的用法：

正确的API端点与方法

要更新现有变量组，你需要使用PATCH方法（而非PUT），并且URL必须包含目标变量组的ID。标准的端点格式如下：

https://<your-org>.visualstudio.com/<project>/_apis/distributedtask/variablegroups/{groupId}?api-version=7.1-preview.2

注：api-version可以选择最新的稳定版本，比如7.1-preview.2是目前常用的预览版本，也可以使用7.0这样的正式版本。

请求体与头部要求

请求头必须设置Content-Type: application/json
请求体只需包含你想要更新的变量（PATCH会做部分更新，保留其他未提及的变量）：
```
{
  "variables": {
    "somevariable": {
      "value": "12"
    }
  }
}
```

完整请求示例（curl）

curl -X PATCH \
  https://dev.azure.com/your-org/your-project/_apis/distributedtask/variablegroups/123?api-version=7.1-preview.2 \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64-encoded-personal-access-token>" \
  -d '{
    "variables": {
      "somevariable": {
        "value": "12"
      }
    }
  }'

关于PUT方法的补充

如果你确实想使用PUT（全量替换变量组），同样需要在URL中指定变量组ID，并且请求体必须包含变量组的完整信息（比如name、variables所有内容），因为PUT是“创建或替换”操作。示例请求体如下：

{
  "name": "Your Variable Group Name",
  "variables": {
    "somevariable": {"value": "12"},
    "othervariable": {"value": "existing-value"}
  },
  "description": "Updated variable group"
}

不过通常推荐用PATCH做部分更新，更灵活且不易丢失现有变量。