列出项目的分支规则

引入于极狐GitLab 15.8。

本指南展示如何使用 GraphiQL Explorer 查询给定项目中的分支规则。

示例查询通过其完整路径(例如 gitlab-org/gitlab-docs)在极狐GitLab 实例中查找项目。 在查询中,我们请求项目的所有已配置分支规则。

note您可以使用 cURL 通过 HTTP 端点直接运行相同的查询。关于更多信息,请参阅命令行的入门指南。

设置 GraphiQL Explorer

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

  1. 复制以下代码摘录:

    query {
      project(fullPath: "gitlab-org/gitlab-docs") {
        branchRules {
          nodes {
            name
            isDefault
            isProtected
            matchingBranchesCount
            createdAt
            updatedAt
            branchProtection {
              allowForcePush
              codeOwnerApprovalRequired
              mergeAccessLevels {
                nodes {
                  accessLevel
                  accessLevelDescription
                  user {
                    name
                  }
                  group {
                    name
                  }
                }
              }
              pushAccessLevels {
                nodes {
                  accessLevel
                  accessLevelDescription
                  user {
                    name
                  }
                  group {
                    name
                  }
                }
              }
              unprotectAccessLevels {
                nodes {
                  accessLevel
                  accessLevelDescription
                  user {
                    name
                  }
                  group {
                    name
                  }
                }
              }
            }
            externalStatusChecks {
              nodes {
                id
                name
                externalUrl
              }
            }
            approvalRules {
              nodes {
                id
                name
                type
                approvalsRequired
                eligibleApprovers {
                  nodes {
                    name
                  }
                }
              }
            }
          }
        }
      }
    }
    
  2. 打开 GraphiQL Explorer 工具
  3. 将上面列出的 query 粘贴到 GraphiQL Explorer 工具的左侧窗口中。
  4. 选择 Play,结果如下:

    GraphiQL explorer query for branch rules

如果没有显示分支规则,可能是因为:

  • 没有配置分支规则。
  • 您的角色无权查看分支规则。管理员可以访问所有记录。