# 访问控制

如果使用 project_full_path,确保 project_full_path 编码过,例子:/api/v3/projects/tencent/code--> /api/v3/projects/tencent%2Fcode (/ 编码 %2F)

# 获取访问控制配置

查看项目的访问控制配置。(包括 IP 白名单、用户白名单、特定访问规则 IP 白名单、特定访问规则用户白名单)

GET /api/v3/projects/:id/acl/config

参数:

参数 类型 描述
id integer 或 string 项目 ID 或 项目全路径 project_full_path

返回值:

{
    "project_id": 1,
    "acl_enabled": true,
    "allow_ips": "127.0.0.1;30.20.165.0/24",
    "allow_users": "git_01;git_02",
    "spec_allow_ips": "30.20.165.46",
    "spec_hit_users": "git_03"
}

# 更新项目访问控制配置

更新项目访问控制中的 ACL 开关、IP 白名单、用户白名单、特定访问规则 IP 白名单、特定访问规则用户白名单

PUT /api/v3/projects/:id/acl/config

参数:

参数 类型 描述
id integer 或 string 项目 ID 或 项目全路径 project_full_path
acl_enabled boolean(可选) 项目 ACL 开关
allow_ips string(可选) 项目 IP 白名单 (如有多个请用英文";"分隔)
allow_users string(可选) 项目用户白名单 (如有多个请用英文";"分隔)
spec_allow_ips string(可选) 项目特定访问规则 IP 白名单 (如有多个请用英文";"分隔)
spec_hit_users string(可选) 项目特定访问规则用户白名单 (如有多个请用英文";"分隔)

返回值:

{
    "project_id": 1,
    "acl_enabled": true,
    "allow_ips": "127.0.0.1;30.20.165.0/24",
    "allow_users": "git_01;git_02",
    "spec_allow_ips": "30.20.165.46",
    "spec_hit_users": "git_03"
}
lastUpdate: 7/9/2026, 4:21:34 PM