如何解决Azure Update Manager触发Azure DevOps Webhook的数组Payload兼容问题

由于Azure Update Manager关联的Event Grid主题（Maintenance Configuration类型）无法自定义事件模式，且Azure DevOps Webhook仅接受单个对象格式的Payload，可通过Azure Function或Logic Apps作为中间层完成格式转换与验证处理，具体实现步骤如下：

方法一：使用Azure Function作为中间转发层 #

1. 创建HTTP触发的Azure Function #

创建一个Python或C#的HTTP触发Function，实现两个核心逻辑：

• 处理Event Grid的订阅验证请求
• 将Event Grid发送的数组Payload提取为单个对象，转发至Azure DevOps Webhook

Python示例代码

import azure.functions as func
import requests
import json

def main(req: func.HttpRequest) -> func.HttpResponse:
    req_body = req.get_json()
    
    # 处理Event Grid订阅验证请求
    if req_body[0]["eventType"] == "Microsoft.EventGrid.SubscriptionValidationEvent":
        validation_code = req_body[0]["data"]["validationCode"]
        return func.HttpResponse(
            json.dumps({"validationResponse": validation_code}),
            mimetype="application/json"
        )
    
    # 提取单个事件对象并转发至Azure DevOps Webhook
    event_payload = req_body[0]
    # 替换为你的Azure DevOps Webhook实际地址
    devops_webhook_url = "https://dev.azure.com/myorg/_apis/public/distributedtask/webhooks/mywebhook?api-version=6.0-preview"
    
    try:
        response = requests.post(devops_webhook_url, json=event_payload)
        response.raise_for_status()
        return func.HttpResponse("事件转发成功", status_code=200)
    except Exception as e:
        return func.HttpResponse(f"转发失败：{str(e)}", status_code=500)

2. 配置Event Grid订阅 #

• 部署上述Function后，复制包含访问密钥的Function触发URL
• 在Azure门户中找到目标Maintenance Configuration，创建Event Grid订阅：
  • 选择要监听的维护事件（如维护前事件）
  • 端点类型选择Webhook，粘贴Function的触发URL
  • 完成订阅后，Event Grid会自动发送验证请求，Function将自动处理验证

3. 验证流程 #

当Azure Update Manager触发维护事件时：

1. Event Grid向Function发送数组格式的Payload
2. Function提取数组中的单个事件对象，转发至Azure DevOps Webhook
3. Azure DevOps接收到符合格式要求的Payload，触发流水线

方法二：使用Logic Apps作为中间层 #

若不熟悉代码开发，可通过Logic Apps可视化配置完成转发：

• 创建一个空白Logic App，添加HTTP触发器作为起始节点
• 添加Parse JSON动作，解析Event Grid的数组格式Payload
• 添加Condition动作，判断是否为订阅验证事件：
  • 若是，返回包含validationResponse的JSON响应
  • 若否，提取数组中的第一个事件对象，调用Azure DevOps Webhook动作

关键说明 #

• Maintenance Configuration主题属于系统主题，确实无法自定义事件输出格式，中间层是当前唯一可行的解决方案
• 中间层必须处理Event Grid的订阅验证逻辑，否则事件订阅无法创建成功

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