그룹 가져오기 및 내보내기 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, 자체 관리, GitLab 전용

새 위치로 그룹 구조를 가져와서 가져오기 API를 사용합니다. 프로젝트 가져오기 및 내보내기 API와 함께 그룹 수준의 관계인 프로젝트 이슈와 그룹 에픽 간의 연결을 보존할 수 있습니다.

그룹 가져오기에는 다음이 포함됩니다:

  • 그룹 마일스톤
  • 그룹 보드
  • 그룹 레이블
  • 그룹 뱃지
  • 그룹 멤버
  • 그룹 위키 (프리미엄 및 얼티메이트 전용)
  • 서브그룹. 각 서브그룹에는 위의 모든 데이터가 포함됩니다.

가져온 프로젝트에서 그룹 수준의 관계를 보존하려면 먼저 그룹을 가져오고 가져온 프로젝트를 원하는 그룹 구조로 가져와야 합니다.

가져온 그룹에는 알려진 이슈로 인해 개인 가시성 수준이 설정됩니다. 기본적으로, 그룹을 상위 그룹에 가져오면 하위 그룹은 상위 그룹과 동일한 가시성 수준을 상속받습니다.

가져온 그룹의 구성원 목록과 해당 권한을 보존하려면 해당 그룹의 사용자를 확인하세요. 원하는 그룹을 가져오기 전에 이러한 사용자가 존재하는지 확인하세요.

전제 조건

새로운 내보내기 일정

새 그룹 내보내기를 시작합니다. 

POST /groups/:id/export
속성 유형 필수 설명
id integer/string yes 인증된 사용자가 소유한 그룹의 ID 
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/1/export"

{
  "message": "202 Accepted"
}

내보내기 다운로드

완료된 내보내기를 다운로드하세요. 

GET /groups/:id/export/download
속성 유형 필수 설명
id integer/string yes 인증된 사용자가 소유한 그룹의 ID 
group=1
token=secret
curl --request GET\
     --header "PRIVATE-TOKEN: ${token}" \
     --output download_group_${group}.tar.gz \
     "https://gitlab.example.com/api/v4/groups/${group}/export/download"

ls *export.tar.gz
2020-12-05_22-11-148_namespace_export.tar.gz

그룹을 내보내는 데 소요되는 시간은 그룹의 크기에 따라 다를 수 있습니다. 이 엔드포인트는 다음 중 하나를 반환합니다:

  • 내보낸 아카이브(사용 가능한 경우)
  • 404 메시지

파일 가져오기

자체 관리형 인스턴스의 관리자가 최대 가져오기 파일 크기를 설정할 수 있습니다(기본값은 0(무제한)입니다). 관리자로서는 최대 가져오기 파일 크기를 다음과 같이 수정할 수 있습니다:

GitLab.com에서 최대 가져오기 파일 크기에 대한 정보는 계정 및 한도 설정를 참조하세요. 

POST /groups/import
속성 유형 필수 설명
name string yes 가져올 그룹의 이름
path string yes 새 그룹의 이름 및 경로
file string yes 업로드할 파일
parent_id integer no 가져올 그룹을 가져올 상위 그룹의 ID. 제공되지 않으면 현재 사용자의 네임스페이스로 기본값이 설정됩니다.

파일 시스템에서 파일을 업로드하려면 --form 인수를 사용하세요. 이렇게 하면 cURL이 Content-Type: multipart/form-data 헤더를 사용하여 데이터를 전송합니다. file= 매개변수는 파일 시스템의 파일을 가리켜야 하며, @ 앞에 와야 합니다. 예: 

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     --form "name=imported-group" --form "path=imported-group" \
     --form "file=@/path/to/file" "https://gitlab.example.com/api/v4/groups/import"

관련 주제