azure-devops - 如何从 Azure DevOps Services REST API 获取可用区域路径？

Question

我找不到如何从 API 检索区域路径。我能够到达迭代路径，但不能到达区域路径。

我在技术上使用 c# 包装器

我试过了

ProjectHttpClient.GetProject()

ProjectHttpClient.GetProjectPropertiesAsync();

WorkItemTrackingHttpClient.GetFieldAsync("System.AreaPath");

WorkItemTrackingHttpClient.GetWorkItemTypeFieldWithReferencesAsync();

自从我从那里获得迭代以来，我也查看了 WorkHttpClient。

我浏览了文档，找不到任何东西。即使搜索“区域”也没有结果。

Answer 1

以下是您正在寻找的 API 调用:

https://docs.microsoft.com/en-us/rest/api/azure/devops/wit/classification%20nodes/get%20classification%20nodes?view=azure-devops-rest-5.1

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes?$depth={$depth}&api-version=5.0

这将为您提供根节点及其子节点，之后您可以查询单个子节点，例如我得到的子节点:

id            : 32
identifier    : GUID
name          : childname
structureType : area
hasChildren   : False
path          : \parent\Area\childname
url           : https://dev.azure.com/xxx/yyy/_apis/wit/classificationNodes/Are
                as/childname

C# API:

_destinationTfs = new VssConnection(new Uri(TfsUri), new VssBasicCredential(string.Empty, AccessToken));
_witClient = _destinationTfs.GetClient<WorkItemTrackingHttpClient>();

var areaPathNode = await _witClient.GetClassificationNodeAsync("PROJECT_NAME", TreeStructureGroup.Areas, depth: 1);
// areaPathNode.Children will contain all your area paths.

附:它非常好地隐藏在 API 文档中