azure-devops - VSTS 拉取请求 API - 如何获取 IdentityRef

Question

我正在使用 VSTS Pullrequest create API 方法来自动创建 PR，在请求中我需要为 createdby/autocompleteby/reviewers 属性提供各种 IdentityRef id 值。在我的情况下，我只有用户详细信息(如全名、电子邮件地址 - user1@domain.com )，在这种情况下，我如何检索 IdentityRef Guid 以便我可以将其传递给 PR Create API。

https://docs.microsoft.com/en-us/rest/api/azure/devops/git/pull%20requests/create?view=azure-devops-rest-5.0

任何帮助表示赞赏。

Answer 1

1) 使用 Graph - List Users ，还要检查 X-MS-ContinuationToken 响应 header 以确定是否还有其他分页数据要检索。如果是，请使用继续 token 值重新发送请求，直到返回所有值:

GET https://vssps.dev.azure.com/{organization}/_apis/graph/users?api-version=5.0-preview.1 ，其次是

GET https://vssps.dev.azure.com/{organization}/_apis/graph/users?continuationToken={continuationToken}&api-version=5.0-preview.1

(我想知道这是否就是为什么您在上面的评论中只获得 500 个用户的原因。不幸的是，文档没有列出此 API 的最大页面大小。如果您使用的是延续 token 并且没有返回所有用户，对我来说，这听起来像是一个 API 错误。)

2) 使用 Get User Entitlements .这提供了 顶部 和 跳过 参数。 顶部 根据文档，参数有 10000 条记录限制。

GET https://vsaex.dev.azure.com/{organization}/_apis/userentitlements?top=10000&api-version=5.0-preview.2