调用Azure DevOps跨项目共享变量组API报参数空异常如何解决

报错核心原因 #

出现该参数空值异常，是3个调用细节不符合接口要求导致：

• 未在请求头显式声明Content-Type: application/json，服务端未解析JSON格式的请求体，直接判定目标参数为空。
• 接口路径格式错误：variableGroupId需要作为路径段拼接，不能作为query参数传递。
• 请求体结构不完整：该版本接口要求请求体必须携带变量组本身的基础属性，不能仅传variableGroupProjectReferences字段；同时该字段的数组中必须包含变量组原所属项目的关联信息，不能只传目标共享项目的配置。

正确调用方式 #

1. 接口基础配置
   • 请求方法：PATCH
   • 正确路径格式：https://dev.azure.com/{organization}/_apis/distributedtask/variablegroups/{variableGroupId}?api-version=6.0-preview.2
2. 必填请求头

   Content-Type: application/json
   Authorization: Basic {个人访问令牌PAT对应的Base64编码值}
   

3. 标准请求体示例

   {
       "name": "变量组原始名称",
       "type": "Vsts",
       "variableGroupProjectReferences": [
           {
               "name": "变量组在原项目的显示名",
               "projectReference": {
                   "id": "变量组原所属项目ID"
               }
           },
           {
               "name": "test1",
               "description": "test1",
               "projectReference": {
                   "id": "50f7c113-de21-4e19-b910-b37ebffa984f",
                   "name": "Customer Services"
               }
           }
       ]
   }
   

   注意：projectReference中的项目ID为必填项，项目名称仅做辅助校验，不可单独传名称不传ID。

4. 成功校验标准
   接口返回200状态码后，检查返回体的variableGroupProjectReferences字段，确认所有关联项目都在列表中，即可在目标项目的变量组库中看到共享的变量组。

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