TFS API - minTime 过滤器不起作用

Question

minTime 参数是否需要 API 版本级别才能正常工作？

GET https://{accountName}.visualstudio.com/{project}/_apis/build/builds?api-version=3.1&minTime=?????

我们在本地运行 TFS api ver 3.1，minTime 似乎对我们不起作用。

很高兴知道什么参数适用于什么 api 版本。

文档说4.1支持这个参数：

maxTime query       
string
date-time   
If specified, filters to builds that finished/started/queued before this date based on the queryOrder specified.

minTime query       
string
date-time   
If specified, filters to builds that finished/started/queued after this date based on the queryOrder specified.

Answer 1

是的，minTime 和 maxTime 参数自 api-version=4.1 起受支持。

请参阅 REST API：Builds - List 了解详情。它提到了所有可用的URI Parameters 和api-version=4.1。

在您的方案中，TFS 2017 不支持api-version=4.1。它仅支持 api ver 3.xx 及更早版本（1.0、2.0）。详情请见REST API Versioning-Supported versions。

因此，如果您想使用 minTime 和 maxTime 参数，您可以升级到 TFS 2018 或迁移到 VSTS。

您也可以使用其他工具按日期过滤构建，例如，您可以在 PowerShell 中通过调用 REST API 进行过滤。

Param(
   [string]$baseurl = "http://server:8080/tfs/DefaultCollection",  
   [string]$projectName = "ProjectName",
   [string]$user = "username",
   [string]$token = "password"
)

# Base64-encodes the Personal Access Token (PAT) appropriately
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$token)))

$uri = "$baseurl/$($projectName)/_apis/build/builds"

$result = Invoke-RestMethod -Uri $uri -Method GET  -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}

$builds = $result.value | Where {$_.finishTime -ge '2018-05-24' -and $_.finishTime -le '2018-05-29'} # Filter builds by finish time between '2018-05-24' and '2018-05-29'