DevOps REST API：使用 "userDescriptor" 参数

Question

我有以下问题 API：https://docs.microsoft.com/en-us/rest/api/azure/devops/graph/users/get?view=azure-devops-rest-5.1

这是 DevOps --> Graph 下的“Users-Get”API。使用此 API 的网络请求中的三个输入参数之一是“userDescriptor”，指定为 “所需用户的描述符。” 文档中提供的示例对理解如何使用此参数没有帮助。

我正在尝试“获取”特定用户，我想知道如何使用此参数来完成此操作，最好是通过指定 UPN。我特别想知道是否 1. 这是可能的，以及 2. 如果是这样，语法是什么。

感谢您的帮助！

Answer 1

使用来自 Azure DevOps 的主题查询API 图

参考：https://docs.microsoft.com/en-us/rest/api/azure/devops/graph/subject%20query/query?view=azure-devops-rest-6.0

像这样定义正文：

{
    "query": "Term to search (e.g. UPN)",
    "subjectKind": [ "User" ]
}

在结果中，您可以找到您将从 GET USER 端点获得的有关用户的所有信息。

{
    "count": 1,
    "value": [
        {
          "subjectKind": "user",
          "domain": "45aa3d2d-7442-473d-b4d3-3c670da9dd96",
          "principalName": "jtseng@vscsi.us",
          "mailAddress": "jtseng@vscsi.us",
          "origin": "aad",
          "originId": "55c8c7b6-7ace-43bc-918f-304dfa2b6317",
          "displayName": "Jia-hao Tseng",
          "_links": {
            "self": {
              "href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/Users/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
            },
            "memberships": {
              "href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/Memberships/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
            },
            "membershipState": {
              "href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/MembershipStates/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
            },
            "storageKey": {
              "href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/StorageKeys/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
            },
            "avatar": {
              "href": "https://dev.azure.com/Fabrikam/_apis/GraphProfile/MemberAvatars/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
            }
          },
          "url": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/Users/aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4",
          "descriptor": "aad.MDA0NzBlMzQtZGE2MS03YTY5LWJkOTYtNDg3YTg0OWVjNTU4"
        }
    ]
}

DevOps REST API：使用 "userDescriptor" 参数

DevOps REST API: using the "userDescriptor" parameter

azure-devops

azure-devops-rest-api