그룹 저장소 이동 API

요약

이 API를 사용하여 그룹 저장소 이동을 관리합니다. GitLab이 그룹 저장소 이동을 처리하면서 다양한 상태를 거칩니다. 데이터 무결성을 보장하기 위해 GitLab은 이동 기간 동안 그룹을 임시 읽기 전용 상태로 설정합니다.

이 API를 사용하여 그룹 저장소 이동을 관리합니다. 이 API는 예를 들어 Gitaly 클러스터(Praefect)로 마이그레이션하거나 그룹 위키를 마이그레이션하는 데 도움이 됩니다. 이 API는 그룹의 프로젝트 저장소를 관리하지 않습니다. 프로젝트 이동을 예약하려면 프로젝트 저장소 이동 API를 사용합니다.

GitLab이 그룹 저장소 이동을 처리하면서 다양한 상태를 거칩니다. state 값은 다음과 같습니다:

initial: 레코드가 생성되었지만 백그라운드 작업이 아직 예약되지 않았습니다.
scheduled: 백그라운드 작업이 예약되었습니다.
started: 그룹 저장소가 대상 저장소로 복사되고 있습니다.
replicated: 그룹이 이동되었습니다.
failed: 그룹 저장소 복사에 실패했거나 체크섬이 일치하지 않았습니다.
finished: 그룹이 이동되었고 소스 저장소의 저장소가 삭제되었습니다.
cleanup failed: 그룹이 이동되었지만 소스 저장소의 저장소를 삭제할 수 없었습니다.

데이터 무결성을 보장하기 위해 GitLab은 이동 기간 동안 그룹을 임시 읽기 전용 상태로 설정합니다. 이 기간 동안 사용자가 새 커밋을 푸시하려고 하면 다음 메시지를 받게 됩니다:

The repository is temporarily read-only. Please try again later.

이 API는 관리자로 인증해야 합니다.

다른 유형의 저장소를 이동하는 API도 있습니다:

모든 그룹 저장소 이동 목록 조회#

인스턴스의 모든 그룹 저장소 이동을 나열합니다.

GET /group_repository_storage_moves

기본적으로 GET 요청은 API 결과가 페이지네이션되기 때문에 한 번에 20개의 결과를 반환합니다.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/group_repository_storage_moves"

응답 예시:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "group": {
      "id": 283,
      "web_url": "https://gitlab.example.com/groups/testgroup",
      "name": "testgroup"
    }
  }
]

그룹의 모든 저장소 이동 목록 조회#

지정된 그룹의 모든 저장소 이동을 나열합니다.

GET /groups/:group_id/repository_storage_moves

기본적으로 GET 요청은 API 결과가 페이지네이션되기 때문에 한 번에 20개의 결과를 반환합니다.

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves"

응답 예시:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "group": {
      "id": 283,
      "web_url": "https://gitlab.example.com/groups/testgroup",
      "name": "testgroup"
    }
  }
]

그룹 저장소 이동 조회#

지정된 그룹 저장소 이동을 조회합니다.

GET /group_repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`repository_storage_id`	정수	예	그룹 저장소 이동의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/group_repository_storage_moves/1"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

그룹의 저장소 이동 조회#

그룹의 지정된 저장소 이동을 조회합니다.

GET /groups/:group_id/repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.
`repository_storage_id`	정수	예	그룹 저장소 이동의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves/1"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

그룹 저장소 이동 생성#

지정된 그룹의 그룹 저장소 이동을 생성합니다. 이 엔드포인트는:

그룹 위키 저장소만 이동합니다.
그룹의 프로젝트 저장소는 이동하지 않습니다. 프로젝트 이동을 예약하려면 프로젝트 저장소 이동 API를 사용합니다.

POST /groups/:group_id/repository_storage_moves

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.
`destination_storage_name`	문자열	아니요	대상 스토리지 샤드의 이름. 제공되지 않으면 스토리지 가중치에 따라 스토리지가 선택됩니다.

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"destination_storage_name":"storage2"}' \
     --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

스토리지 샤드의 그룹 저장소 이동 생성#

지정된 스토리지 샤드의 모든 그룹에 대한 저장소 이동을 생성합니다.

POST /group_repository_storage_moves

지원되는 속성:

속성	유형	필수	설명
`source_storage_name`	문자열	예	소스 스토리지 샤드의 이름.
`destination_storage_name`	문자열	아니요	대상 스토리지 샤드의 이름. 제공되지 않으면 스토리지 가중치에 따라 스토리지가 선택됩니다.

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"source_storage_name":"default"}' \
     --url "https://gitlab.example.com/api/v4/group_repository_storage_moves"

응답 예시:

{
  "message": "202 Accepted"
}

그룹 저장소 이동 API

Tier: Premium, Ultimate
Offering: GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-05-22

요약

GitLab이 그룹 저장소 이동을 처리하면서 다양한 상태를 거칩니다. state 값은 다음과 같습니다:

initial: 레코드가 생성되었지만 백그라운드 작업이 아직 예약되지 않았습니다.
scheduled: 백그라운드 작업이 예약되었습니다.
started: 그룹 저장소가 대상 저장소로 복사되고 있습니다.
replicated: 그룹이 이동되었습니다.
failed: 그룹 저장소 복사에 실패했거나 체크섬이 일치하지 않았습니다.
finished: 그룹이 이동되었고 소스 저장소의 저장소가 삭제되었습니다.
cleanup failed: 그룹이 이동되었지만 소스 저장소의 저장소를 삭제할 수 없었습니다.

The repository is temporarily read-only. Please try again later.

이 API는 관리자로 인증해야 합니다.

다른 유형의 저장소를 이동하는 API도 있습니다:

모든 그룹 저장소 이동 목록 조회#

인스턴스의 모든 그룹 저장소 이동을 나열합니다.

GET /group_repository_storage_moves

기본적으로 GET 요청은 API 결과가 페이지네이션되기 때문에 한 번에 20개의 결과를 반환합니다.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/group_repository_storage_moves"

응답 예시:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "group": {
      "id": 283,
      "web_url": "https://gitlab.example.com/groups/testgroup",
      "name": "testgroup"
    }
  }
]

그룹의 모든 저장소 이동 목록 조회#

지정된 그룹의 모든 저장소 이동을 나열합니다.

GET /groups/:group_id/repository_storage_moves

기본적으로 GET 요청은 API 결과가 페이지네이션되기 때문에 한 번에 20개의 결과를 반환합니다.

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves"

응답 예시:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "group": {
      "id": 283,
      "web_url": "https://gitlab.example.com/groups/testgroup",
      "name": "testgroup"
    }
  }
]

그룹 저장소 이동 조회#

지정된 그룹 저장소 이동을 조회합니다.

GET /group_repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`repository_storage_id`	정수	예	그룹 저장소 이동의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/group_repository_storage_moves/1"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

그룹의 저장소 이동 조회#

그룹의 지정된 저장소 이동을 조회합니다.

GET /groups/:group_id/repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.
`repository_storage_id`	정수	예	그룹 저장소 이동의 ID.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves/1"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

그룹 저장소 이동 생성#

지정된 그룹의 그룹 저장소 이동을 생성합니다. 이 엔드포인트는:

그룹 위키 저장소만 이동합니다.
그룹의 프로젝트 저장소는 이동하지 않습니다. 프로젝트 이동을 예약하려면 프로젝트 저장소 이동 API를 사용합니다.

POST /groups/:group_id/repository_storage_moves

지원되는 속성:

속성	유형	필수	설명
`group_id`	정수	예	그룹의 ID.
`destination_storage_name`	문자열	아니요	대상 스토리지 샤드의 이름. 제공되지 않으면 스토리지 가중치에 따라 스토리지가 선택됩니다.

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"destination_storage_name":"storage2"}' \
     --url "https://gitlab.example.com/api/v4/groups/1/repository_storage_moves"

응답 예시:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "group": {
    "id": 283,
    "web_url": "https://gitlab.example.com/groups/testgroup",
    "name": "testgroup"
  }
}

스토리지 샤드의 그룹 저장소 이동 생성#

지정된 스토리지 샤드의 모든 그룹에 대한 저장소 이동을 생성합니다.

POST /group_repository_storage_moves

지원되는 속성:

속성	유형	필수	설명
`source_storage_name`	문자열	예	소스 스토리지 샤드의 이름.
`destination_storage_name`	문자열	아니요	대상 스토리지 샤드의 이름. 제공되지 않으면 스토리지 가중치에 따라 스토리지가 선택됩니다.

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"source_storage_name":"default"}' \
     --url "https://gitlab.example.com/api/v4/group_repository_storage_moves"

응답 예시:

{
  "message": "202 Accepted"
}

그룹 저장소 이동 API

모든 그룹 저장소 이동 목록 조회#

그룹의 모든 저장소 이동 목록 조회#

그룹 저장소 이동 조회#

그룹의 저장소 이동 조회#

그룹 저장소 이동 생성#

스토리지 샤드의 그룹 저장소 이동 생성#

관련 항목#

그룹 저장소 이동 API

모든 그룹 저장소 이동 목록 조회#

그룹의 모든 저장소 이동 목록 조회#

그룹 저장소 이동 조회#

그룹의 저장소 이동 조회#

그룹 저장소 이동 생성#

스토리지 샤드의 그룹 저장소 이동 생성#

관련 항목#