如何使用python-gitlab API为已创建的GitLab项目添加关联群组
用python-gitlab为GitLab项目添加关联群组的实现方法
你之前查询的邀请接口仅用于邀请单个用户,给项目添加关联群组本质是将群组共享到目标项目,对应GitLab的项目共享群组API,在python-gitlab中可以直接调用项目对象的内置方法实现。
前置准备
- 先安装python-gitlab依赖:
pip install python-gitlab - 提前准备好GitLab实例地址、个人访问令牌(需要有项目所有者权限)、目标项目ID、待关联的群组ID。
完整实现代码
import gitlab # 初始化GitLab连接 gl = gitlab.Gitlab('你的GitLab实例地址', private_token='你的个人访问令牌') gl.auth() # 1. 获取目标项目对象,替换为你的项目ID project_id = 123 project = gl.projects.get(project_id) # 2. 配置关联参数 group_id = 456 # 替换为你要关联的群组ID access_level = gitlab.constants.DEVELOPER_ACCESS # 给群组设置的项目权限级别 # 可选:设置权限到期时间,格式为YYYY-MM-DD,不需要可以不传该参数 expires_at = "2024-12-31" # 3. 执行关联操作 project.share(group_id, access_level, expires_at=expires_at)
补充说明
- 常用的权限级别常量可以直接从
gitlab.constants中获取:GUEST_ACCESS:访客权限REPORTER_ACCESS:报告者权限DEVELOPER_ACCESS:开发者权限MAINTAINER_ACCESS:维护者权限OWNER_ACCESS:所有者权限
- 如需查询当前项目已关联的所有群组,执行
project.shared_with_groups.list()即可 - 如需取消某群组和项目的关联,执行
project.unshare(待取消的群组ID)即可
注意:操作账号需要同时具备目标项目的「所有者」权限,以及待关联群组的至少「报告者」权限,否则会触发权限报错
内容的提问来源于stack exchange,提问作者Martin Cronje
相关产品推荐
相关产品推荐

