如何从 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.

ps。它在 API 文档中隐藏得非常好