저장소 태그 존재 확인
저장소 태그 존재 확인 (Check repository tags)
Docker Hub API에서 저장소에 태그가 있는지 확인하는 작업이에요. HEAD 요청을 보내서 태그 존재 여부만 빠르게 확인할 수 있어요. 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.
출처: 문서
본문
HEAD 요청으로 저장소에 태그가 있는지 확인합니다. bearerAuth 인증이 필요해요. 응답 본문 없이 상태 코드로 결과를 알 수 있어요.
파라미터
| 파라미터 | 위치 | 설명 |
|---|---|---|
namespace |
path (필수) | 저장소가 속한 네임스페이스 |
repository |
path (필수) | 확인할 저장소 이름 |
응답
200: 저장소에 태그가 있음 (응답 본문 없음)403: 권한 없음 (permission denied)404: 대상을 찾을 수 없음 (not found)
예시 요청
curl \
--head \
--header "Authorization: Bearer ***" \
--header 'Accept: application/json' \
'https://hub.docker.com/v2/namespaces/<NAMESPACE>/repositories/<REPOSITORY>/tags'
더 알아보기
- 특정 태그 존재 확인 (Check repository tag): 개별 태그 단위 확인 작업을 살펴봐요.
- 네임스페이스 저장소 목록 (List repositories in a namespace): 저장소 목록 조회 작업을 확인해요.