如何使用 Azure DevOps REST APi 获取构建作业？

Question

因此，我可以获得构建详细信息，但它不包含有关构建作业的任何信息。例如。每个构建作业都在构建代理上运行 - 我如何使用 REST Api 获取这一部分？

我们谈论的是 vNext 构建，而不是 XAML。

Answer 1

您可以在时间线记录中找到所有任务和工作：时间线 - 获取。您可以将此模板粘贴到浏览器中以检查特定构建的结果：

https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline

我使用 Microsoft.TeamFoundationServer.Client 包，这是它的示例：

    static void PrintTimeLine(string TeamProjectName, int BuildId)
    {
        var timeline = BuildClient.GetBuildTimelineAsync(TeamProjectName, BuildId).Result;

        if (timeline.Records.Count > 0)
        {
            Console.WriteLine("Task Name-----------------------------Start Time---Finish Time---Result");
            foreach(var record in timeline.Records)
                if (record.RecordType == "Task")
                Console.WriteLine("{0, -35} | {1, -10} | {2, -10} | {3}",
                    (record.Name.Length < 35) ? record.Name : record.Name.Substring(0, 35), 
                    (record.StartTime.HasValue) ? record.StartTime.Value.ToLongTimeString() : "",
                    (record.FinishTime.HasValue) ? record.FinishTime.Value.ToLongTimeString() : "",
                    (record.Result.HasValue) ? record.Result.Value.ToString() : "");
        }
    }

https://github.com/ashamrai/TFRestApi/blob/master/19.TFRestApiAppQueueBuild/TFRestApiApp/Program.cs

Answer 2

https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}

会让您知道对象下使用的代理

queue

，并显示代理队列（91）号和池ID（8）

"queue":{  
      "id":91,
      "name":"MotBuild-Default",
      "pool":{  
         "id":8,
         "name":"MotBuild-Default"
      }

使用

https://dev.azure.com/{org}/_apis/distributedtask/pools/{pool_id}?api-version=5.0-preview.1

或

https://dev.azure.com/{org}/{project}/_apis/distributedtask/queues/{queue_id}

将返还矿池。

所以现在使用

https://dev.azure.com/{org}/_apis/distributedtask/pools/{pool_id}/agents

将返回代理池下的代理列表

现在我已经解释了所有内容，让我们尝试将所有内容联系在一起。

1. 使用

   https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}

   找到队列和池 ID。

2. 使用

   https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline

   并找到类型为

   Job

   的记录和属性

   workerName

   ，它将返回所使用的代理的NAME。

3. 使用

   https://dev.azure.com/{org}/_apis/distributedtask/pools/{pool_id}/agents

   查询代理，并通过从上面第 2 步中找到的名称过滤

   id

   来查找代理

   name

   。

4. 最后查询

   https://dev.azure.com/{org}/_apis/distributedtask/pools/{pool_id}/agents/{agent_id}

   将返回代理的高级信息，信息不多。

下一个 api 未记录

5. 要获取详细的功能查询

   https://dev.azure.com/{org}/_apis/distributedtask/pools/{pool_id}/agents/{agent_id}?includeCapabilities=true

   ，将返回一个巨大的结果集！ 我想这就是你想要的。

了解有关 API 的更多信息：

• 泳池
• 队列
• 代理商