Azure DevOps中使用API创建变量组失败问题排查

算力阿峰

2026-7-12

Azure DevOps变量组创建失败问题：原因及修复方案

问题原因

错误提示“Atleast one variable group project reference is required”的核心原因是请求体中variableGroupProjectReferences字段格式不符合API要求。该字段要求为数组类型，即使只关联单个项目，也需要用数组包裹项目引用对象，而你当前传入的是单个对象，导致API无法识别有效的项目引用。

修正后的请求体

将variableGroupProjectReferences修改为数组形式即可解决问题：

vargroup_data = {
            "name": "MyVariableGroup",
            "description": "This is my variable group",
            "type": "Vsts",
            "variables": {
                "myVariable": {
                "value": "myValue",
                "isSecret": False
                },
                "myPublicVariable": {
                "value": "myPublicValue",
                "isSecret": False
                }
            },
            "variableGroupProjectReferences": [
                {
                    "projectReference": {
                        "id": project_id,
                        "name": project
                    }
                }
            ]
        }