Azure Devops 领域 API

Azure Devops Area API

我发现并成功测试了通过 API 为项目创建区域。

POSThttps://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=6.0

{ “名称”:“网络” }

这会默认创建一个区域,该区域是项目区域的子区域。

项目名称 > 区域名称

我看不到通过嵌套在多个区域(子)中的 API 在线创建区域的方法,因此在下面的示例中通过 API 我想创建“子区域名称":

项目名称 > 区域 1 名称 > 子区域名称

如果有人曾经这样做过,请提供任何建议。

您应该能够将 path 属性 添加到您的 POST 请求以在子路径下创建区域:

{ 
    "name": "Child Area Name",
    "path": "/area 1 name"
}

我记得以前有时遇到过同样的挑战,最终使用了不同的 API 来创建子区域。这是我所做的:

每个区域路径(和迭代路径)都有其唯一的 ID。您可以使用 documented REST APIs 检索所有区域路径(或迭代路径)。比如你可以用下面的API获取所有的区域路径(你可以决定你要查询的深度)

https://dev.azure.com/{Org}/{project}/_apis/wit/classificationnodes/Areas?$depth={depth}&api-version=6.0

以上将为您提供具有唯一 ID 的每个节点的层次结构。您需要获取要在其下创建下一个 sub-area 的 node/sub-node 的 ID。 接下来您可以创建如下所示的有效负载:

{ 
   operationData: "{ \"NodeName\": \"Sub-Area1\", \"ParentId\": \"Parent-GUID-You-Got-Earlier\" }", // Notice the value here is already serialized
   syncWorkItemTracking: false
}

最后,post将上述有效载荷发送到以下 URI:

var uri = "https://dev.azure.com/{Org}/{projectId}/_admin/_Areas/CreateClassificationNode?useApiUrl=true&__v=5"

它将创建 sub-area 并将 return 新创建的 sub-area 节点信息(包括 ID)的 ID。

希望这对你有所帮助。

PS:如果有人可以分享谁知道如何使用 standard/documented API 实现相同的效果,请分享。