如何通过GitLab Rest API设置GitLab Pages可见性为所有人可见

GitLab没有单独的Pages可见性配置API，该参数直接包含在项目的创建、更新接口参数中，具体使用方式如下：

1. 已有项目修改可见性 #

调用项目更新接口 PUT /projects/:id，传入pages_access_level参数即可：

• 参数值说明：
  • private：仅项目成员可见（默认值）
  • enabled：所有人（含未登录访客）可见
  • 部分旧版本GitLab可使用public作为enabled的别名，优先使用enabled兼容性更好
• curl请求示例：

curl --request PUT \
  --url "https://<your-gitlab-domain>/api/v4/projects/<project-id>" \
  --header "PRIVATE-TOKEN: <your-access-token>" \
  --form "pages_access_level=enabled"

要求访问令牌持有项目维护者及以上权限，且GitLab实例/所属群组未限制Pages公开权限

2. 新建项目时直接配置 #

如果是自动创建新项目的场景，不需要额外调用更新接口，直接在创建项目的POST /projects接口请求参数中增加pages_access_level=enabled即可，项目创建完成后Pages默认对所有人开放。

常见不生效原因 #

• GitLab实例全局配置关闭了公开Pages的权限
• 项目所属的群组/命名空间设置了Pages可见性上限，不允许公开
• 访问令牌权限不足，没有项目的编辑权限

内容的提问来源于stack exchange，提问作者Nicolas