AzureFunction@1任务回调：如何在Azure管道中显示自定义消息？

问题描述 #

我在Azure YAML管道中使用AzureFunction@1任务，根据官方文档，可通过回调指示任务执行成功或失败，此功能已正常工作。现想了解：是否可在管道中显示自定义消息以汇总执行情况？例如任务失败时显示“因X、Y、Z原因失败”；若不可行，能否通过C#代码从其他监听进程轮询回调URL获取消息？

一、在Azure管道中显示自定义执行消息 #

完全可以实现，这是AzureFunction@1任务原生支持的能力。

当你通过回调URL向管道反馈任务状态时，除了必填的status字段（取值为succeeded或failed），还可以额外添加message字段，传入自定义的汇总文本。管道会自动将这条消息展示在任务的执行日志和摘要中。

示例回调请求的JSON内容：

{
  "status": "failed",
  "message": "因X、Y、Z原因失败"
}

发送这个回调后，你就能在Azure管道的任务日志里直接看到这条自定义失败原因，无需额外配置。另外，如果需要在任务执行过程中输出更多中间日志，也可以在Azure函数中通过Console.WriteLine()打印内容，这些日志会被实时捕获并显示在管道的日志面板中。

二、通过C#代码轮询回调URL获取消息 #

这种方案是可行的，但需要注意几个关键点：

• 回调URL的时效性：该URL是Azure管道为单次任务生成的临时链接，仅在任务执行周期内有效，任务完成后会立即失效。
• 权限与网络可达性：回调URL仅允许Azure管道内部和具备网络访问权限的请求访问，需确保你的C#进程能正常连接到该URL。

C#轮询示例代码 #

using System;
using System.Net.Http;
using System.Threading.Tasks;

class TaskStatusPoller
{
    static async Task Main(string[] args)
    {
        if (args.Length == 0)
        {
            Console.WriteLine("请传入回调URL作为参数");
            return;
        }

        string callbackUrl = args[0];
        using var httpClient = new HttpClient();

        while (true)
        {
            try
            {
                var response = await httpClient.GetAsync(callbackUrl);
                if (response.IsSuccessStatusCode)
                {
                    var responseContent = await response.Content.ReadAsStringAsync();
                    Console.WriteLine($"任务状态反馈: {responseContent}");

                    // 检查任务是否已完成，完成则终止轮询
                    if (responseContent.Contains("\"status\":\"succeeded\"") || 
                        responseContent.Contains("\"status\":\"failed\""))
                    {
                        Console.WriteLine("任务已完成，停止轮询");
                        break;
                    }
                }
                else
                {
                    Console.WriteLine($"请求失败，状态码: {response.StatusCode}");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"轮询出错: {ex.Message}");
            }

            await Task.Delay(5000); // 每5秒轮询一次，可根据需求调整
        }
    }
}

使用时，只需在Azure管道中将AzureFunction@1生成的回调URL作为参数传递给这个C#程序即可。

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