如何通过GitLab API及Shell脚本获取全部GitLab组ID？

你的当前脚本仅指定了固定页码（page=30），只能拿到该页的组ID，无法获取全部。以下是几种能遍历所有分页、获取完整组ID列表的方案：

方案1：循环遍历所有页码（基础版） #

通过循环请求每一页数据，直到返回空数组时停止，适合快速实现：

#!/bin/bash
# 用法：./get-all-group-ids.sh <your-gitlab-token>

TOKEN="$1"
API_URL="https://gitlab.com/api/v4/groups"
PER_PAGE=100  # GitLab API允许的最大每页数量，减少请求次数
PAGE=1

while true; do
    # 请求当前页的组数据
    response=$(curl -s --header "PRIVATE-TOKEN: $TOKEN" "$API_URL?per_page=$PER_PAGE&page=$PAGE")
    # 检查返回的组数量，为空则退出循环
    group_count=$(echo "$response" | jq '. | length')
    if [ "$group_count" -eq 0 ]; then
        break
    fi
    # 提取并输出当前页的所有组ID
    echo "$response" | jq -r '.[].id'
    # 页码自增
    PAGE=$((PAGE + 1))
done

方案2：利用响应头的Link字段自动处理分页（更优雅） #

GitLab API的响应头中会包含Link字段，标记下一页的URL，通过解析这个字段可以自动遍历所有分页，无需手动维护页码：

#!/bin/bash
# 用法：./get-all-group-ids.sh <your-gitlab-token>

TOKEN="$1"
CURRENT_URL="https://gitlab.com/api/v4/groups?per_page=100"
TEMP_HEADERS="/tmp/gitlab-api-headers.txt"

while [ -n "$CURRENT_URL" ]; do
    # 发送请求，同时保存响应头到临时文件
    response=$(curl -s -D "$TEMP_HEADERS" --header "PRIVATE-TOKEN: $TOKEN" "$CURRENT_URL")
    # 提取当前页的组ID
    echo "$response" | jq -r '.[].id'
    # 从响应头中解析下一页的URL，没有则设为空
    CURRENT_URL=$(grep -i '^Link:' "$TEMP_HEADERS" | sed -E 's/.*<([^>]+)>; rel="next".*/\1/')
done

# 清理临时文件
rm "$TEMP_HEADERS"

方案3：使用GitLab官方CLI（glab） #

如果安装了GitLab官方命令行工具glab，可以用更简洁的命令一键获取所有组ID，无需处理分页逻辑：

首先确保已安装glab并完成登录配置，然后执行：

# 直接输出所有组ID
glab group list --all --format 'json' | jq -r '.[].id'

# 或者用CSV格式提取（跳过表头）
glab group list --all --format 'csv' --fields 'ID' | tail -n +2

注意事项 #

• 确保你的GitLab令牌（PRIVATE-TOKEN）拥有read_api权限，否则无法访问组列表接口
• per_page参数最大设为100，能减少总请求次数，提升效率

内容的提问来源于stack exchange，提问作者Giridhar Kumar Jha