使用Azure DevOps API更新变量组时提示「项目信息名称无效」

开发者阿泽

2026-8-19

解决Azure DevOps变量组API更新报错"Project information name is not valid for variable group"

问题重现

调用Azure DevOps变量组更新API（PUT方法）时，无论使用何种请求体，均返回以下错误：

{
"$id": "1",
"innerException": null,
"message": "Project information name is not valid for variable group.",
"typeName": "System.ArgumentException, mscorlib",
"typeKey": "ArgumentException",
"errorCode": 0,
"eventId": 0
}

同时，使用同一URL的GET请求可正常返回变量组完整信息。

问题原因

该错误多出现于项目级变量组的更新场景：

PUT请求URL未包含项目路径，仅指定组织，导致API无法识别变量组所属的项目上下文
请求体缺失projectReference字段，而该字段是项目级变量组更新的必填项

解决方案

步骤1：确认变量组范围

通过GET请求获取变量组详情，查看返回结果中是否存在projectReference字段：

存在则为项目级变量组
不存在则为组织级变量组

步骤2：调整PUT请求URL（针对项目级变量组）

将URL修改为包含项目名称的格式：

https://dev.azure.com/{organization}/{project}/_apis/distributedtask/variablegroups/{groupId}?api-version=6.0-preview.2

步骤3：完善PUT请求体

在请求体中加入从GET结果中复制的完整projectReference字段，示例请求体如下：

{
  "name": "JobStatus",
  "type": "Vsts",
  "variables": {
      "rest-var1": {
          "isSecret": false,
          "value": "rest-var-value-1"
      }
  },
  "projectReference": {
    "id": "{项目ID}",
    "name": "{项目名称}"
  }
}