时间戳

首页 > 解决方案 > DevOps REST API：使用“userDescriptor”参数

azure-devops - DevOps REST API：使用“userDescriptor”参数

问题描述

我对以下 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 的 webrequest 中的三个输入参数之一是“userDescriptor”之一，指定为“所需用户的描述符”。文档中提供的示例对理解如何使用此参数没有帮助。

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

感谢您的帮助！

标签： azure-devopsazure-devops-rest-api

解决方案

使用 Azure DevOps API Graph 中的主题查询

参考：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"
        }
    ]
}

推荐阅读