보호된 브랜치 API

보호된 브랜치 API에 대해 설명합니다.

이 API를 사용하여 보호된 브랜치 를 관리합니다. GitLab Premium 및 GitLab Ultimate는 브랜치에 대한 푸시를 더 세분화된 방식으로 보호할 수 있습니다. 관리자는 특정 사용자 대신 배포 키에만 보호된 브랜치를 수정하고 푸시할 수 있는 권한을 부여할 수 있습니다. 유효한 액세스 수준 # ProtectedRefAccess.allowed_access_levels 메서드는 푸시, 머지, 보호 해제 구성에서 사용되는 다음 액세스 수준을 정의합니다: 0 : 액세스 없음 - 푸시 및 머지 액세스 수준에만 유효합니다. 보호 해제 액세스 수준에는 유효하지 않습니다. 30 : Developer 40 : Maintainer 60 : Administrator - GitLab Self-Managed에서만 유효합니다. 역할 기반 액세스 수준 외에도 다음으로 액세스를 할당할 수 있습니다: 사용자 ( user_id ): 푸시, 머지, 보호 해제 액세스 수준에 유효합니다. 그룹 ( group_id ): 푸시, 머지, 보호 해제 액세스 수준에 유효합니다. 그룹은 프로젝트에 대해 Developer, Maintainer 또는 Owner 역할이 있어야 합니다. 배포 키 ( deploy_key_id ): 푸시 액세스 수준에만 유효합니다. 자세한 내용은 저장소 브랜치 보호 예시 를 참조하세요. Warning 브랜치의 보호 설정이 영구적으로 잠기지 않도록, 항상 최소한 한 명의 사용자 또는 그룹이 해당 브랜치에 대한 보호 해제 권한을 유지하도록 하세요. 자세한 내용은 브랜치 보호 해제 가능 사용자 제어 를 참조하세요. 보호된 브랜치 목록 조회 # 히스토리 배포 키 정보가 GitLab 16.0에서 도입 되었습니다. UI에서 정의된 대로 프로젝트의 보호된 브랜치 목록을 가져옵니다. 와일드카드가 설정된 경우, 해당 와일드카드와 일치하는 브랜치의 정확한 이름 대신 와일드카드가 반환됩니다. GET /projects/:id/protected_branches 지원되는 속성: 속성 타입 필수 여부 설명 id integer 또는 string 예 프로젝트의 ID 또는 URL 인코딩된 경로 . search string 아니요 검색할 보호된 브랜치의 이름 또는 이름 일부. 성공 시 200 OK 와 함께 다음 응답 속성을 반환합니다: 속성 타입 설명 allow_force_push boolean true 이면 이 브랜치에 강제 푸시가 허용됩니다. code_owner_approval_required boolean true 이면 이 브랜치에 푸시하려면 코드 소유자 승인이 필요합니다. id integer 보호된 브랜치의 ID. inherited boolean true 이면 보호 설정이 상위 그룹에서 상속됩니다. Premium 및 Ultimate 전용. merge_access_levels array 머지 액세스 수준 구성 배열. merge_access_levels[].access_level integer 머지를 위한 액세스 수준. merge_access_levels[].access_lev