미러
미러링된 리포지토리의 상태와 미러가 따라가는 피드.
이 그룹의 작업과 각 작업의 액세스 규칙, 재시도 규칙, 매개 변수, 응답입니다. 모든 요청에는 키가 포함됩니다: Authorization: Bearer <키>(“인증” 참조).
작업
이 설치의 미러와 가져오기 목록
GET HEAD /api/v1/mirrors
액세스: 호출자가 볼 수 있는 리포지토리(repository.read) · 재시도: 반복해도 안전함(읽기)
이 서버가 다른 Arkvory에서 미러링하거나 가져오며 호출자가 읽을 수 있는 각 저장소에 대해, 저장소 하나의 미러 상태와 같은 정보를 반환합니다: 원본, mode, phase, cursor와 head, caughtUp, 마지막 확인·동기화·오류, 복사된 아티팩트와 바이트 수. 호출자가 읽을 수 없는 저장소는 제외되며, 미러가 없는 설치는 빈 목록으로 응답합니다.
응답 200
| 필드 | 형식 | 필수 | 규칙 |
|---|---|---|---|
items | object 배열 | 예 | 요소 64개 이하 |
items[].repository | string | 예 | — |
items[].upstream | string (uri) | 예 | — |
items[].sourceRepository | string | 예 | — |
items[].mode | string | 예 | mirror, import 중 하나 |
items[].stages | string 배열 | 예 | 요소 16개 이하 |
items[].phase | string | 예 | pending, seeding, following 중 하나 |
items[].seedStep | string | 예 | artifacts, packages, assets 중 하나; null일 수 있음 |
items[].cursor | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송 |
items[].head | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송; null일 수 있음 |
items[].caughtUp | boolean | 예 | null일 수 있음 |
items[].checkedAt | string (date-time) | 예 | null일 수 있음 |
items[].syncedAt | string (date-time) | 예 | null일 수 있음 |
items[].errorCode | string | 예 | null일 수 있음 |
items[].errorAt | string (date-time) | 예 | null일 수 있음 |
items[].copiedArtifacts | integer | 예 | 0 이상 |
items[].copiedBytes | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송 |
items[].conflicts | object | 예 | — |
items[].conflicts.count | integer | 예 | 0 이상 |
items[].conflicts.oldestAt | string (date-time) | 예 | null일 수 있음 |
items[].conflicts.sample | object 배열 | 예 | 요소 10개 이하 |
응답: 200, 400, 401, 403, 404, 409, 422, 503, 507
예제
curl -X GET "$ARKVORY_URL/api/v1/mirrors" \
-H "Authorization: Bearer $ARKVORY_TOKEN"미러의 동기화 상태 조회
GET HEAD /api/v1/repositories/{repository}/mirror
액세스: 리포지토리 권한: repository.read; 파일 키: read · 재시도: 반복해도 안전함(읽기)
이 서버가 다른 Arkvory에서 미러링하는 리포지토리(ARKVORY_MIRRORS_FILE에 구성)에 대해 원본, mode, phase, 적용된 cursor와 원본의 head, caughtUp, 마지막 확인, 동기화, 오류, 복사된 아티팩트와 바이트를 반환합니다. mode는 mirror(읽기 전용 사본) 또는 import(나열된 stages가 붙은 버전을 인수함)이고, phase는 pending, seeding, following 중 하나입니다. 순번은 원본 저널의 번호이므로 그 차이는 변경 수가 아닙니다. 일반 리포지토리는 404로 응답합니다.
매개 변수
| 이름 | 위치 | 형식 | 필수 | 규칙 |
|---|---|---|---|---|
repository | 경로 | string | 예 | ^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치 |
응답 200
| 필드 | 형식 | 필수 | 규칙 |
|---|---|---|---|
repository | string | 예 | — |
upstream | string (uri) | 예 | — |
sourceRepository | string | 예 | — |
mode | string | 예 | mirror, import 중 하나 |
stages | string 배열 | 예 | 요소 16개 이하 |
phase | string | 예 | pending, seeding, following 중 하나 |
seedStep | string | 예 | artifacts, packages, assets 중 하나; null일 수 있음 |
cursor | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송 |
head | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송; null일 수 있음 |
caughtUp | boolean | 예 | null일 수 있음 |
checkedAt | string (date-time) | 예 | null일 수 있음 |
syncedAt | string (date-time) | 예 | null일 수 있음 |
errorCode | string | 예 | null일 수 있음 |
errorAt | string (date-time) | 예 | null일 수 있음 |
copiedArtifacts | integer | 예 | 0 이상 |
copiedBytes | string | 예 | 10진수 숫자로 쓴 정수이며 문자열로 전송 |
conflicts | object | 예 | — |
conflicts.count | integer | 예 | 0 이상 |
conflicts.oldestAt | string (date-time) | 예 | null일 수 있음 |
conflicts.sample | object 배열 | 예 | 요소 10개 이하 |
conflicts.sample[].artifactId | string (uuid) | 예 | — |
conflicts.sample[].action | string | 예 | — |
conflicts.sample[].detail | string | 예 | null일 수 있음 |
conflicts.sample[].code | string | 예 | — |
conflicts.sample[].firstAt | string (date-time) | 예 | — |
conflicts.sample[].lastAt | string (date-time) | 예 | — |
conflicts.sample[].attempts | integer | 예 | 1 이상 |
응답: 200, 400, 401, 403, 404, 409, 422, 503, 507
예제
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY/mirror" \
-H "Authorization: Bearer $ARKVORY_TOKEN"