REST API 리소스
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-Managed, GitLab Dedicated
GitLab REST API의 사용 가능한 리소스는 다음과 같은 맥락으로 그룹화할 수 있습니다:
프로젝트 리소스
다음과 같은 API 리소스가 프로젝트 컨텍스트에서 사용 가능합니다:
| 리소스 | 사용 가능한 엔드포인트 |
|---|---|
| 접근 요청 |
/projects/:id/access_requests (그룹에서도 사용 가능)
|
| 접근 토큰 |
/projects/:id/access_tokens (그룹에서도 사용 가능)
|
| 에이전트 | /projects/:id/cluster_agents
|
| 브랜치 |
/projects/:id/repository/branches/, /projects/:id/repository/merged_branches
|
| 커밋 |
/projects/:id/repository/commits, /projects/:id/statuses
|
| 컨테이너 레지스트리 | /projects/:id/registry/repositories
|
| 사용자 정의 속성 |
/projects/:id/custom_attributes (그룹 및 사용자에서도 사용 가능)
|
| Composer 배포 |
/projects/:id/packages/composer (그룹에서도 사용 가능)
|
| Conan 배포 |
/projects/:id/packages/conan (독립형에서도 사용 가능)
|
| 데비안 배포 |
/projects/:id/debian_distributions (그룹에서도 사용 가능)
|
| 데비안 패키지 |
/projects/:id/packages/debian (그룹에서도 사용 가능)
|
| 의존성 | /projects/:id/dependencies
|
| 배포 키 |
/projects/:id/deploy_keys (독립형에서도 사용 가능)
|
| 배포 토큰 |
/projects/:id/deploy_tokens (그룹 및 독립형에서도 사용 가능)
|
| 배포 | /projects/:id/deployments
|
| 토론 (스레드 형태의 댓글) |
/projects/:id/issues/.../discussions, /projects/:id/snippets/.../discussions, /projects/:id/merge_requests/.../discussions, /projects/:id/commits/.../discussions (그룹에서도 사용 가능)
|
| 임시 노트 (댓글) | /projects/:id/merge_requests/.../draft_notes
|
| 이모지 반응 |
/projects/:id/issues/.../award_emoji, /projects/:id/merge_requests/.../award_emoji, /projects/:id/snippets/.../award_emoji
|
| 환경 | /projects/:id/environments
|
| 에러 추적 | /projects/:id/error_tracking/settings
|
| 이벤트 |
/projects/:id/events (사용자 및 독립형에서도 사용 가능)
|
| 외부 상태 확인 | /projects/:id/external_status_checks
|
| 피처 플래그 사용자 디렉터리 | /projects/:id/feature_flags_user_lists
|
| 피처 플래그 | /projects/:id/feature_flags
|
| 동결 기간 | /projects/:id/freeze_periods
|
| Go 프록시 | /projects/:id/packages/go
|
| Helm 리포지터리 | /projects/:id/packages/helm_repository
|
| 통합 (이전 “서비스”) | /projects/:id/integrations
|
| 초대 |
/projects/:id/invitations (그룹에서도 사용 가능)
|
| 이슈 보드 | /projects/:id/boards
|
| 이슈 링크 | /projects/:id/issues/.../links
|
| 이슈 통계 |
/projects/:id/issues_statistics (그룹 및 독립형에서도 사용 가능)
|
| 이슈 |
/projects/:id/issues (그룹 및 독립형에서도 사용 가능)
|
| 이터레이션 |
/projects/:id/iterations (그룹에서도 사용 가능)
|
| 프로젝트 CI/CD 작업 토큰 범위 | /projects/:id/job_token_scope
|
| 작업 |
/projects/:id/jobs, /projects/:id/pipelines/.../jobs
|
| 작업 아티팩트 | /projects/:id/jobs/:job_id/artifacts
|
| 라벨 | /projects/:id/labels
|
| Maven 리포지터리 |
/projects/:id/packages/maven (그룹 및 독립형에서도 사용 가능)
|
| 멤버 |
/projects/:id/members (그룹에서도 사용 가능)
|
| Merge Request 승인 |
/projects/:id/approvals, /projects/:id/merge_requests/.../approvals
|
| Merge Request |
/projects/:id/merge_requests (그룹 및 독립형에서도 사용 가능)
|
| Merge Train | /projects/:id/merge_trains
|
| 메타데이터 | /metadata
|
| 노트 (댓글) |
/projects/:id/issues/.../notes, /projects/:id/snippets/.../notes, /projects/:id/merge_requests/.../notes (그룹에서도 사용 가능)
|
| 알림 설정 |
/projects/:id/notification_settings (그룹 및 독립형에서도 사용 가능)
|
| NPM 리포지터리 | /projects/:id/packages/npm
|
| NuGet 패키지 |
/projects/:id/packages/nuget (그룹에서도 사용 가능)
|
| 패키지 | /projects/:id/packages
|
| 페이지 도메인 |
/projects/:id/pages/domains (독립형에서도 사용 가능)
|
| 페이지 설정 | /projects/:id/pages
|
| 파이프라인 스케줄 | /projects/:id/pipeline_schedules
|
| 파이프라인 트리거 | /projects/:id/triggers
|
| 파이프라인 | /projects/:id/pipelines
|
| 프로젝트 뱃지 | /projects/:id/badges
|
| 프로젝트 클러스터 | /projects/:id/clusters
|
| 프로젝트 가져오기/내보내기 |
/projects/:id/export, /projects/import, /projects/:id/import
|
| 프로젝트 마일스톤 | /projects/:id/milestones
|
| 프로젝트 스니펫 | /projects/:id/snippets
|
| 프로젝트 템플릿 | /projects/:id/templates
|
| 프로젝트 취약점. | /projects/:id/vulnerabilities
|
| 프로젝트 위키 | /projects/:id/wikis
|
| 프로젝트 수준 변수 | /projects/:id/variables
|
| 프로젝트 웹훅 설정 포함 |
/projects, /projects/:id/hooks (사용자에서도 사용 가능)
|
| 보호된 브랜치 | /projects/:id/protected_branches
|
| 보호된 환경 | /projects/:id/protected_environments
|
| 보호된 태그 | /projects/:id/protected_tags
|
| PyPI 패키지 |
/projects/:id/packages/pypi (그룹에서도 사용 가능)
|
| 릴리스 링크 | /projects/:id/releases/.../assets/links
|
| 릴리스 | /projects/:id/releases
|
| 원격 미러 | /projects/:id/remote_mirrors
|
| 리포지터리 | /projects/:id/repository
|
| 리포지터리 파일 | /projects/:id/repository/files
|
| 리포지터리 서브모듈 | /projects/:id/repository/submodules
|
| 리소스 레이블 이벤트 |
/projects/:id/issues/.../resource_label_events, /projects/:id/merge_requests/.../resource_label_events (그룹에서도 사용 가능)
|
| 루비 젬 | /projects/:id/packages/rubygems
|
| 러너(runner) |
/projects/:id/runners (독립형에서도 사용 가능)
|
| 검색 |
/projects/:id/search (그룹 및 독립형에서도 사용 가능)
|
| 태그 | /projects/:id/repository/tags
|
| 테라폼 모듈 |
/projects/:id/packages/terraform/modules (독립형에서도 사용 가능)
|
| 사용자 별 메트릭 대시보드 | /projects/:id/metrics/user_starred_dashboards
|
| 취약점 | /vulnerabilities/:id
|
| 취약점 내보내기 | /projects/:id/vulnerability_exports
|
| 취약점 결과 | /projects/:id/vulnerability_findings
|
그룹 리소스
다음 API 리소스는 그룹 컨텍스트에서 사용할 수 있습니다.
| 리소스 | 사용 가능한 엔드포인트 |
|---|---|
| 액세스 요청 |
/groups/:id/access_requests/ (프로젝트에서도 사용 가능)
|
| 액세스 토큰 |
/groups/:id/access_tokens (프로젝트에서도 사용 가능)
|
| 사용자 정의 속성 |
/groups/:id/custom_attributes (프로젝트 및 사용자에서도 사용 가능)
|
| Debian 배포 |
/groups/:id/-/packages/debian (프로젝트에서도 사용 가능)
|
| 배포 토큰 |
/groups/:id/deploy_tokens (프로젝트 및 독립형에서도 사용 가능)
|
| 토론 (댓글 및 스레드) |
/groups/:id/epics/.../discussions (프로젝트에서도 사용 가능)
|
| 에픽 이슈 | /groups/:id/epics/.../issues
|
| 에픽 링크 | /groups/:id/epics/.../epics
|
| 에픽 | /groups/:id/epics
|
| 그룹 |
/groups, /groups/.../subgroups
|
| 그룹 뱃지 | /groups/:id/badges
|
| 그룹 이슈 보드 | /groups/:id/boards
|
| 그룹 이터레이션 |
/groups/:id/iterations (프로젝트에서도 사용 가능)
|
| 그룹 레이블 | /groups/:id/labels
|
| 그룹 수준 변수 | /groups/:id/variables
|
| 그룹 마일스톤 | /groups/:id/milestones
|
| 그룹 릴리스 | /groups/:id/releases
|
| 그룹 SSH 인증서 | /groups/:id/ssh_certificates
|
| 그룹 위키 | /groups/:id/wikis
|
| 초대 |
/groups/:id/invitations (프로젝트에서도 사용 가능)
|
| 이슈 |
/groups/:id/issues (프로젝트 및 독립형에서도 사용 가능)
|
| 이슈 통계 |
/groups/:id/issues_statistics (프로젝트 및 독립형에서도 사용 가능)
|
| 연결된 에픽 | /groups/:id/epics/.../related_epics
|
| 멤버 역할 | /groups/:id/member_roles
|
| 멤버 |
/groups/:id/members (프로젝트에서도 사용 가능)
|
| Merge Request |
/groups/:id/merge_requests (프로젝트 및 독립형에서도 사용 가능)
|
| 노트 (댓글) |
/groups/:id/epics/.../notes (프로젝트에서도 사용 가능)
|
| 알림 설정 |
/groups/:id/notification_settings (프로젝트 및 독립형에서도 사용 가능)
|
| 자원 레이블 이벤트 |
/groups/:id/epics/.../resource_label_events (프로젝트에서도 사용 가능)
|
| 검색 |
/groups/:id/search (프로젝트 및 독립형에서도 사용 가능)
|
독립형 리소스
다음 API 리소스는 프로젝트 및 그룹 컨텍스트 외부에서 사용할 수 있습니다(/users 포함):
| 리소스 | 사용 가능한 엔드포인트 |
|---|---|
| 외형 | /application/appearance
|
| 응용 프로그램 | /applications
|
| 감사 이벤트 | /audit_events
|
| 아바타 | /avatar
|
| 브로드캐스트 메시지 | /broadcast_messages
|
| 코드 스니펫 | /snippets
|
| 코드 제안 | /code_suggestions
|
| 사용자 정의 속성 |
/users/:id/custom_attributes (그룹 및 프로젝트에서도 사용 가능)
|
| 의존성 디렉터리 내보내기 |
/pipelines/:id/dependency_list_exports, /projects/:id/dependency_list_exports, /groups/:id/dependency_list_exports, /security/dependency_list_exports/:id, /security/dependency_list_exports/:id/download
|
| 배포 키 |
/deploy_keys (프로젝트에서도 사용 가능)
|
| 배포 토큰 |
/deploy_tokens (프로젝트 및 그룹에서도 사용 가능)
|
| 이벤트 |
/events, /users/:id/events (프로젝트에서도 사용 가능)
|
| 피처 플래그 | /features
|
| Geo 노드 | /geo_nodes
|
| 그룹 활동 분석 | /analytics/group_activity/{issues_count}
|
| 그룹 리포지터리 스토리지 이동 | /group_repository_storage_moves
|
| GitHub에서 리포지터리 가져오기 | /import/github
|
| Bitbucket Server에서 리포지터리 가져오기 | /import/bitbucket_server
|
| 인스턴스 클러스터 | /admin/clusters
|
| 인스턴스 수준 CI/CD 변수 | /admin/ci/variables
|
| 이슈 통계 |
/issues_statistics (그룹 및 프로젝트에서도 사용 가능)
|
| 이슈 |
/issues (그룹 및 프로젝트에서도 사용 가능)
|
| 작업 | /job
|
| 키 | /keys
|
| 라이선스 | /license
|
| 마크다운 | /markdown
|
| Merge Request |
/merge_requests (그룹 및 프로젝트에서도 사용 가능)
|
| 메트릭 대시보드 주석 |
/environments/:id/metrics_dashboard/annotations, /clusters/:id/metrics_dashboard/annotations
|
| 네임스페이스 | /namespaces
|
| 알림 설정 |
/notification_settings (그룹 및 프로젝트에서도 사용 가능)
|
| 페이지 도메인 |
/pages/domains (프로젝트에서도 사용 가능)
|
| 개인 액세스 토큰 | /personal_access_tokens
|
| 플랜 한도 | /application/plan_limits
|
| 프로젝트 리포지터리 스토리지 이동 | /project_repository_storage_moves
|
| 프로젝트 |
/users/:id/projects (프로젝트에서도 사용 가능)
|
| 러너(runner) |
/runners (프로젝트에서도 사용 가능)
|
| 검색 |
/search (그룹 및 프로젝트에서도 사용 가능)
|
| 서비스 데이터 |
/usage_data (GitLab 인스턴스 관리자 사용자 전용)
|
| 설정 | /application/settings
|
| Sidekiq 메트릭 | /sidekiq
|
| Sidekiq 큐 관리 | /admin/sidekiq/queues/:queue_name
|
| 스니펫 리포지터리 스토리지 이동 | /snippet_repository_storage_moves
|
| 통계 | /application/statistics
|
| 제안 | /suggestions
|
| 시스템 훅 | /hooks
|
| 할 일 | /todos
|
| 주제 | /topics
|
| 사용자 | /users
|
.gitlab-ci.yml 파일 유효성 검사
| /lint
|
| 버전 | /version
|
템플릿 API 리소스
다음과 같은 엔드포인트를 사용할 수 있습니다:
- Dockerfile 템플릿
.gitignore템플릿- GitLab CI/CD YAML 템플릿(templates/gitlab_ci_ymls.md)
- 오픈 소스 라이선스 템플릿(templates/licenses.md)
도움말