当前位置：文江博客话题详情

TeamCity - 如何通过 REST API 获取当前正在运行的版本？

发布于 2024-10-13 15:55:26 字数 68 浏览 7 评论 0原文

有谁知道如何使用 TeamCity REST API 来找出当前正在运行哪些构建以及它们的运行时间（已用时间与估计时间）？

原文

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

强者自强 2024-10-20 15:55:26

该 URL 返回您所要求的内容，包括完成百分比。
http://teamcityserver/httpAuth/app/rest/builds?locator=running:true

<builds count="1">
    <build id="10" number="8" running="true" percentageComplete="24" status="SUCCESS" buildTypeId="bt3" startDate="20110714T210916+1200" href="/httpAuth/app/rest/builds/id:10" webUrl="http://phillipn02:29000/viewLog.html?buildId=10&buildTypeId=bt3"/>
</builds>

来源：http://devnet.jetbrains.net/message/5291132#5291132。
REST API 文档上的相关行是“http://teamcity: 8111/httpAuth/app/rest/builds/?locator= - 通过“构建定位器”获取构建。在“用法”部分。

这适用于 TeamCity 版本 6.5；我还没有在早期版本上尝试过，但我怀疑它可以回到版本 5。

The URL returns what you are asking for, including percentage complete.
http://teamcityserver/httpAuth/app/rest/builds?locator=running:true

<builds count="1">
    <build id="10" number="8" running="true" percentageComplete="24" status="SUCCESS" buildTypeId="bt3" startDate="20110714T210916+1200" href="/httpAuth/app/rest/builds/id:10" webUrl="http://phillipn02:29000/viewLog.html?buildId=10&buildTypeId=bt3"/>
</builds>

Source: http://devnet.jetbrains.net/message/5291132#5291132.
The relevant line on the REST API documentation is the one that reads "http://teamcity:8111/httpAuth/app/rest/builds/?locator= - to get builds by "build locator"." in the "Usage" section.

This works with TeamCity version 6.5; I haven't tried it on earlier versions, but I suspect it will work back to version 5.

回复收藏 0 原文

热风软妹 2024-10-20 15:55:26

您可以使用“running:true/false/any”作为构建定位器的构建维度之一。（编辑：在 TeamCity 6.0 中添加）

http://confluence.jetbrains.net/display /TW/REST+API+Plugin

TeamCity REST API 文档将为您提供一些构造 URL 的方法的示例。该页面上的“构建定位器”部分将列出用于优化结果的不同选项（其中之一正在运行）。

但是，我不知道如何使用 REST API 获取有关正在运行的构建已用时间/估计时间的信息。我不确定这是否可能。如果您确实找到了一种方法来做到这一点，我将非常有兴趣阅读如何实现！

祝你好运！

回复收藏 0 原文

挽清梦 2024-10-20 15:55:26

我知道你的问题已有五年多了，但你想要

找出当前正在运行的构建以及它们的运行情况（已用时间与估计时间）

接受的答案中建议的方法只提供了 percentageComplete 属性，如果不再次调用 API，该属性就没那么有用。

可以通过提供字段请求来实现url 的参数，例如：

serverUrl/httpAuth/app/rest/builds/?locator=running:true&fields=count,build({buildFields})

其中 {buildFields} 是 builds 对象的属性。为此，我使用：

id,buildTypeId,number,status,branchName,startDate,queuedDate,href,running-info

完整的 url is then

serverUrl/httpAuth/app/rest/builds/?locator=running:true&fields=count,build(id,buildTypeId,number,status,branchName,startDate,queuedDate,href,running-info)

返回类似的内容

<builds count="1">
    <build id="128990" buildTypeId="{build type ID}" number="256" status="SUCCESS" branchName="{branch name}" href="/httpAuth/app/rest/builds/id:128990">
        <running-info percentageComplete="6" elapsedSeconds="52" estimatedTotalSeconds="924" currentStageText="{status}" outdated="false" probablyHanging="false"/>
        <queuedDate>20160421T102558+0100</queuedDate>
        <startDate>20160421T105709+0100</startDate>
    </build>
</builds>

，该内容将为您提供 running-info 元素中的完成百分比和已用/估计总时间。

注意：我使用的是 TeamCity 9；字段请求参数似乎存在在文档中TeamCity 5.x-7.x 但输出可能不太一样。

I realise your question is more than five years old, but you wanted

to find out which builds are currently running, and how far through they are (elapsed time vs estimated time)

The method as suggested in the accepted answer only gives the percentageComplete attribute, which is not as useful without having to make another call to the API.

It can be achieved by supplying the fields request parameter to the url, e.g.:

serverUrl/httpAuth/app/rest/builds/?locator=running:true&fields=count,build({buildFields})

where {buildFields} are properties of the builds object. For this, I am using:

id,buildTypeId,number,status,branchName,startDate,queuedDate,href,running-info

The full url is then

serverUrl/httpAuth/app/rest/builds/?locator=running:true&fields=count,build(id,buildTypeId,number,status,branchName,startDate,queuedDate,href,running-info)

which returns something like

<builds count="1">
    <build id="128990" buildTypeId="{build type ID}" number="256" status="SUCCESS" branchName="{branch name}" href="/httpAuth/app/rest/builds/id:128990">
        <running-info percentageComplete="6" elapsedSeconds="52" estimatedTotalSeconds="924" currentStageText="{status}" outdated="false" probablyHanging="false"/>
        <queuedDate>20160421T102558+0100</queuedDate>
        <startDate>20160421T105709+0100</startDate>
    </build>
</builds>

which will give you the percentage complete and elapsed/estimated total times in the running-info element.

Note: I am using TeamCity 9; the fields request parameter appears to be present in the documentation for TeamCity 5.x-7.x but the output may not be quite the same.

回复收藏 0 原文