如何通过REST调用将JSON复杂对象传入Azure DevOps YAML管道

这是Azure DevOps管道REST触发场景下的常见已知问题，大量开发者都踩过同类型的坑，核心问题出在object类型参数的传参格式不符合API要求。

Azure DevOps的Runs - Run Pipeline接口对templateParameters字段的处理有特殊规则：

• 基础类型参数（字符串、数字、布尔值）可以直接传对应类型的值
• type: object/type: stepList等复杂类型参数，不支持直接传递原生嵌套JSON结构，API侧无法正确完成参数反序列化校验，就会直接返回触发失败
• 当你不传该参数时，管道直接加载yaml里预定义的默认值，走内部参数解析逻辑，不会触发API侧的格式校验，因此可以正常运行

将object类型的参数值序列化为转义后的JSON字符串再传入，修改后的请求体示例如下：

{
    "resources": {
        "repositories": {
            "self": {
                "refName": "refs/heads/main"
            }
        }
    },
    "templateParameters": {
        "extra_tags": "{\"1\": \"one\", \"2\": \"two\"}"
    }
}

• 管道运行时会自动将这个字符串格式的JSON解析回对应object类型，不需要在yaml中额外编写反序列化逻辑，参数使用方式和默认值场景完全一致
• 如果是数组类型的object参数，也遵循同样规则，需要序列化为JSON字符串传递，例："extra_tags": "[\"tag1\",\"tag2\"]"
• 该格式限制仅存在于REST API触发场景，页面手动触发、管道间资源触发等场景不需要做此特殊处理

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