프로젝트 API

GitLab 프로젝트를 생성, 조회, 업데이트, 삭제하는 API 엔드포인트를 설명합니다.

- Tier: Free, Premium, Ultimate - Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 이 API를 사용하여 GitLab 프로젝트와 관련 설정을 관리하세요. 프로젝트는 코드를 저장하고 이슈를 추적하며 팀 활동을 조직하는 협업의 중심 허브입니다. 자세한 내용은 프로젝트 생성 을 참고하세요. 프로젝트 API는 다음 작업을 수행하는 엔드포인트를 포함합니다: 프로젝트 정보 및 메타데이터 조회 프로젝트 생성, 편집 및 삭제 프로젝트 가시성, 접근 권한, 보안 설정 제어 이슈 추적, 머지 리퀘스트, CI/CD 등 프로젝트 기능 관리 프로젝트 아카이브 및 아카이브 해제 네임스페이스 간 프로젝트 이전 배포 및 컨테이너 레지스트리 설정 관리 전제 조건 # 프로젝트 속성을 읽으려면 프로젝트에서 기본 역할 이상이 필요합니다. 프로젝트 속성을 편집하려면 프로젝트에서 Owner 또는 Maintainer 역할이 필요합니다. 프로젝트 가시성 레벨 # GitLab의 프로젝트 가시성 레벨은 다음 중 하나입니다: Private Internal Public 가시성 레벨은 프로젝트의 visibility 필드로 결정됩니다. 자세한 내용은 프로젝트 가시성 을 참고하세요. 응답에서 반환되는 필드는 인증된 사용자의 권한 에 따라 달라집니다. 프로젝트 기능 가시성 레벨 # 프로젝트를 생성하거나 편집할 때 프로젝트 설정의 가용성을 제어할 수 있습니다. 예를 들어, 기존 프로젝트에서 forking_access_level 을 비활성화하려면: curl --request PUT \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-Type: application/json" \ --data '{"forking_access_level": "disabled"}' \ --url "https://gitlab.example.com/api/v4/projects/<project_id>" 각 설정은 독립적으로 정의할 수 있으며 다음 값을 허용합니다: disabled : 기능을 비활성화합니다. private : 기능을 활성화하고 프로젝트 멤버만 으로 설정합니다. enabled : 기능을 활성화하고 접근 권한이 있는 모든 사람 으로 설정합니다. public : 기능을 활성화하고 모든 사람 으로 설정합니다. pages_access_level 에서만 사용 가능합니다. 자세한 내용은 프로젝트 내 개별 기능의 가시성 변경 을 참고하세요. Attribute Type Required Description analytics_access_level string No Set visibility of analytics. builds_access_level string No Set visibility of pipelines. container_registry_access_level string No Set visibility of container registry.