使用 GraphQL 查询用户 (BASIC ALL)

本页介绍如何使用 GraphiQL Explorer 查询用户。

您可以使用 cURL 通过 HTTP 端点直接运行相同的查询。有关详细信息,请参阅我们从命令行开始的指南。

示例用户查询在极狐GitLab 实例中使用用户名或全局 ID查询用户子集: 查询包括:

pageInfo

包括进行分页所需的信息。极狐GitLab 使用基于光标的分页。 详细信息请参见 GraphQL 文档中的分页

nodes

在 GraphQL 查询中,nodes 用于表示图上的 nodes 的集合。 在这种情况下,节点集合是 User 对象的集合。 对于每个对象,我们输出:

  • 用户 id
  • membership 片段,表示用户属于项目或群组的成员资格。输出片段用 ...memberships 符号表示

极狐GitLab GraphQL API 非常广泛,可以输出各种实体的大量数据。

设置 GraphiQL Explorer

此过程提供了一个实质性示例,您可以将其复制并粘贴到 GraphiQL Explorer 中. GraphiQL Explorer 可用于:

  1. 复制以下代码摘录:

     {
       users(usernames: ["user1", "user3", "user4"]) {
         pageInfo {
           endCursor
           startCursor
           hasNextPage
         }
         nodes {
           id
           username,
           publicEmail
           location
           webUrl
           userPermissions {
             createSnippet
           }
         }
       }
     }
    
  2. 打开 GraphiQL Explorer 工具
  3. 将上面列出的 query 粘贴到 GraphiQL Explorer 工具的左侧窗口中。
  4. 选择 Play,结果如下:

GraphiQL explorer search for boards

noteGraphQL API 返回 GlobalID,而不是标准 ID。。还期望输入为 GlobalID 而不是一个整数。

此 GraphQL 查询返回具有所列用户名的三个用户的指定信息。 由于 GraphiQL Explorer 使用会话令牌来授权访问资源,输出仅限于当前经过身份验证的用户可以访问的项目和群组。

如果您以实例管理员的身份登录,则无论所有权如何,您都可以访问所有记录。

如果您以管理员身份登录,则可以通过将 admins: true 参数添加到将第二行更改为以下内容的查询来仅显示匹配的管理员:

  users(usernames: ["user1", "user3", "user4"], admins: true) {
    ...
  }

或者您也可以获取所有管理员:

  users(admins: true) {
    ...
  }

关于以下内容的更多信息:

  • GraphQL 特定实体,例如 Fragments 和接口,请参见 GraphQL 文档