특정 태그 존재 확인

특정 태그 존재 확인 (Check repository tag)

Docker Hub API에서 저장소에 지정한 태그가 있는지 확인하는 작업이에요. HEAD 요청으로 특정 태그 존재 여부만 가볍게 검사할 수 있어요. 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.

출처: 문서

본문

HEAD 요청으로 특정 태그가 저장소에 존재하는지 확인합니다. bearerAuth 인증이 필요해요. 응답 본문 없이 상태 코드로 결과를 알 수 있어요.

파라미터

파라미터 위치 설명
namespace path (필수) 저장소가 속한 네임스페이스
repository path (필수) 확인할 저장소 이름
tag 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/<TAG>'

더 알아보기