Arkvory

리포지토리 ​

호출자가 볼 수 있는 리포지토리와 개별 리포지토리의 세부 정보.

이 그룹의 작업과 각 작업의 액세스 규칙, 재시도 규칙, 매개 변수, 응답입니다. 모든 요청에는 키가 포함됩니다: Authorization: Bearer <키>(“인증” 참조).

작업 ​

접근 가능한 리포지토리 목록 ​

GET HEAD /api/v1/repositories

액세스: 호출자가 볼 수 있는 리포지토리(repository.read) · 재시도: 반복해도 안전함(읽기)

호출자가 권한을 가진 리포지토리를 이름순으로 나열하며, 각 항목에 형식(upack, assets)과 그 리포지토리에서 호출자 자신의 권한을 담습니다. 관리형 서비스 키에는 repository.read 권한이 있는 리포지토리만 보입니다. 리포지토리는 서버 전체 레지스트리의 항목이 아니라 호출자에게 부여된 권한의 범위입니다. 페이지는 limit개 카드(1–100, 기본 50)로 구성되며 after에 next 값을 넣어 이어서 조회합니다.

매개 변수

이름위치형식필수규칙
after쿼리string아니요^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치; Exclusive repository ID boundary; authorization is rechecked on every page.
limit쿼리integer아니요1–100; 기본값 50

응답 200

필드형식필수규칙
itemsobject 배열예요소 100개 이하
items[].idstring예^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치
items[].formatsstring 배열예요소 2–2개; 중복 항목 없음; 각 요소: upack, assets 중 하나
items[].permissionsstring 배열예요소 1–24개; 중복 항목 없음; 각 요소: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read 중 하나
nextstring예^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치; null일 수 있음

응답: 200, 400, 401, 403, 404, 409, 422, 503, 507

예제

bash
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

리포지토리 카드 조회 ​

GET HEAD /api/v1/repositories/{repository}

액세스: 호출자가 볼 수 있는 리포지토리(repository.read) · 재시도: 반복해도 안전함(읽기)

호출자 기준으로 한 리포지토리의 카드, 즉 형식과 그 안에서 호출자의 권한을 반환합니다. 호출자가 볼 수 없는 리포지토리는 존재하지 않는 리포지토리와 똑같이 404로 응답하며, HEAD를 쓰면 가벼운 접근 확인이 됩니다. 리포지토리가 보인다고 해서 그 콘텐츠나 설정에 대한 접근 권한이 생기지는 않습니다.

매개 변수

이름위치형식필수규칙
repository경로string예^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치

응답 200

필드형식필수규칙
idstring예^[a-z0-9][a-z0-9_-]{0,63}$ 패턴과 일치
formatsstring 배열예요소 2–2개; 중복 항목 없음; 각 요소: upack, assets 중 하나
permissionsstring 배열예요소 1–24개; 중복 항목 없음; 각 요소: repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read 중 하나

응답: 200, 400, 401, 403, 404, 409, 422, 503, 507

예제

bash
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
  -H "Authorization: Bearer $ARKVORY_TOKEN"

Arkvory · ProAnimaStudio