REST API 리소스

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitLab REST API의 사용 가능한 리소스는 다음과 같은 컨텍스트로 그룹화할 수 있습니다.

note

프로젝트 리소스

다음과 같은 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
시각적 검토 토론 /projects/:id/merge_requests/:merge_request_id/visual_review_discussions
취약점 /vulnerabilities/:id
취약점 내보내기 /projects/:id/vulnerability_exports
취약점 발견 /projects/:id/vulnerability_findings

그룹 자원

다음과 같은 API 자원이 그룹 컨텍스트에서 사용할 수 있습니다:

자원 사용 가능한 엔드포인트
접근 요청 /groups/:id/access_requests/ (프로젝트에서도 사용 가능)
액세스 토큰 /groups/:id/access_tokens (프로젝트에서도 사용 가능)
사용자 정의 속성 /groups/:id/custom_attributes (프로젝트 및 사용자에서도 사용 가능)
데비안 배포 /groups/:id/-/packages/debian (프로젝트에서도 사용 가능)
배포 토큰 /groups/:id/deploy_tokens (프로젝트 및 독립형에서도 사용 가능)
토론 (댓글 및 스레드) /groups/:id/epics/.../discussions (프로젝트에서도 사용 가능)
Epic 이슈 /groups/:id/epics/.../issues
Epic 링크 /groups/:id/epics/.../epics
Epic /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 (프로젝트 및 독립형에서도 사용 가능)
연결된 Epic /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 리소스

다음과 같은 엔드포인트가 이용 가능합니다: