스니펫 저장소 이동 API

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

GitLab 13.8에서 소개되었습니다.

스니펫 저장소는 저장소 간에 이동될 수 있습니다. 이 API는 예를 들어 Gitaly 클러스터로 이주할 때 도움이 될 수 있습니다.

스니펫 저장소 이동이 처리되는 동안 다양한 상태로 전환됩니다. state 값은 다음과 같습니다.

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

데이터 무결성을 보장하기 위해 스니펫은 이동 기간 동안 임시 읽기 전용 상태로 설정됩니다. 이 기간 동안 사용자가 새 커밋을 푸시하려고 하면 저장소는 임시로 읽기 전용입니다. 나중에 다시 시도해주세요.라는 메시지를 받게 됩니다.

이 API를 사용하려면 관리자로 자격 증명을 인증해야 합니다.

기타 저장소 유형은 다음을 참조하세요:

모든 스니펫 저장소 이동 검색

GET /snippet_repository_storage_moves

기본적으로 GET 요청은 시간당 20개의 결과를 반환합니다. 이는 API 결과가 페이지별로 표시되기 때문입니다.

예시 요청:

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

예시 응답:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "snippet": {
      "id": 65,
      "title": "테스트 스니펫",
      "description": null,
      "visibility": "internal",
      "updated_at": "2020-12-01T11:15:50.385Z",
      "created_at": "2020-12-01T11:15:50.385Z",
      "project_id": null,
      "web_url": "https://gitlab.example.com/-/snippets/65",
      "raw_url": "https://gitlab.example.com/-/snippets/65/raw",
      "ssh_url_to_repo": "ssh://user@gitlab.example.com/snippets/65.git",
      "http_url_to_repo": "https://gitlab.example.com/snippets/65.git"
    }
  }
]

스니펫에 대한 모든 저장소 이동 검색

GET /snippets/:snippet_id/repository_storage_moves

기본적으로 GET 요청은 시간당 20개의 결과를 반환합니다. 이는 API 결과가 페이지별로 표시되기 때문입니다.

지원되는 속성:

속성	유형	필수여부	설명
`snippet_id`	정수	예	스니펫의 ID

예시 요청:

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

예시 응답:

[
  {
    "id": 1,
    "created_at": "2020-05-07T04:27:17.234Z",
    "state": "scheduled",
    "source_storage_name": "default",
    "destination_storage_name": "storage2",
    "snippet": {
      "id": 65,
      "title": "테스트 스니펫",
      "description": null,
      "visibility": "internal",
      "updated_at": "2020-12-01T11:15:50.385Z",
      "created_at": "2020-12-01T11:15:50.385Z",
      "project_id": null,
      "web_url": "https://gitlab.example.com/-/snippets/65",
      "raw_url": "https://gitlab.example.com/-/snippets/65/raw",
      "ssh_url_to_repo": "ssh://user@gitlab.example.com/snippets/65.git",
      "http_url_to_repo": "https://gitlab.example.com/snippets/65.git"
    }
  }
]

단일 스니펫 저장소 이전 가져오기

GET /snippet_repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`repository_storage_id`	정수	예	스니펫 저장소 이전의 ID입니다.

예시 요청:

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

예시 응답:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "snippet": {
    "id": 65,
    "title": "Test Snippet",
    "description": null,
    "visibility": "internal",
    "updated_at": "2020-12-01T11:15:50.385Z",
    "created_at": "2020-12-01T11:15:50.385Z",
    "project_id": null,
    "web_url": "https://gitlab.example.com/-/snippets/65",
    "raw_url": "https://gitlab.example.com/-/snippets/65/raw",
    "ssh_url_to_repo": "ssh://user@gitlab.example.com/snippets/65.git",
    "http_url_to_repo": "https://gitlab.example.com/snippets/65.git"
  }
}

스니펫을 위한 단일 저장소 이전 가져오기

GET /snippets/:snippet_id/repository_storage_moves/:repository_storage_id

지원되는 속성:

속성	유형	필수	설명
`snippet_id`	정수	예	스니펫의 ID입니다.
`repository_storage_id`	정수	예	스니펫 저장소 이전의 ID입니다.

예시 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/snippets/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",
  "snippet": {
    "id": 65,
    "title": "Test Snippet",
    "description": null,
    "visibility": "internal",
    "updated_at": "2020-12-01T11:15:50.385Z",
    "created_at": "2020-12-01T11:15:50.385Z",
    "project_id": null,
    "web_url": "https://gitlab.example.com/-/snippets/65",
    "raw_url": "https://gitlab.example.com/-/snippets/65/raw",
    "ssh_url_to_repo": "ssh://user@gitlab.example.com/snippets/65.git",
    "http_url_to_repo": "https://gitlab.example.com/snippets/65.git"
  }
}

스니펫을 위한 저장소 이전 일정화

GitLab 13.8에서 소개됨.

POST /snippets/:snippet_id/repository_storage_moves

지원되는 속성:

속성	유형	필수	설명
`snippet_id`	정수	예	스니펫의 ID입니다.
`destination_storage_name`	문자열	아니요	대상 저장소 샤드의 이름입니다. 제공되지 않으면 GitLab 13.5 및 이후에는 저장소 가중치에 따라 자동으로 선택됩니다.

예시 요청:

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

예시 응답:

{
  "id": 1,
  "created_at": "2020-05-07T04:27:17.234Z",
  "state": "scheduled",
  "source_storage_name": "default",
  "destination_storage_name": "storage2",
  "snippet": {
    "id": 65,
    "title": "Test Snippet",
    "description": null,
    "visibility": "internal",
    "updated_at": "2020-12-01T11:15:50.385Z",
    "created_at": "2020-12-01T11:15:50.385Z",
    "project_id": null,
    "web_url": "https://gitlab.example.com/-/snippets/65",
    "raw_url": "https://gitlab.example.com/-/snippets/65/raw",
    "ssh_url_to_repo": "ssh://user@gitlab.example.com/snippets/65.git",
    "http_url_to_repo": "https://gitlab.example.com/snippets/65.git"
  }
}

모든 스니펫 리포지토리를 스토리지 샤드로 이동 일정 만들기

GitLab 13.8에서 소개됨

소스 스토리지 샤드에 저장된 각 스니펫 리포지토리에 대해 저장소 이동 일정을 예약합니다. 이 엔드포인트는 한꺼번에 모든 스니펫을 마이그레이션합니다. 자세한 정보는 모든 스니펫 이동을 참조하세요.

POST /snippet_repository_storage_moves

지원되는 속성:

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

예시 요청:

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

예시 응답:

{
  "message": "202 Accepted"
}

스니펫 저장소 이동 API

모든 스니펫 저장소 이동 검색

스니펫에 대한 모든 저장소 이동 검색

단일 스니펫 저장소 이전 가져오기

스니펫을 위한 단일 저장소 이전 가져오기

스니펫을 위한 저장소 이전 일정화

모든 스니펫 리포지토리를 스토리지 샤드로 이동 일정 만들기

도움말

기능 사용 가능성과 제품 평가판

도움받기