Container Registry 개요

Container Registry는 Docker Registry v2 스펙의 프라이빗 도커 컨테이너 이미지 저장소로 컨테이너 이미지를 손쉽게 저장, 관리 및 배포할 수 있는 네이버 클라우드 플랫폼의 서비스입니다.
Container Registry 서비스에서는 레지스트리와 도커 컨테이너 이미지 관리 기능에 대한 API를 RESTful 형태로 제공합니다.

Container Registry API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://ncr.apigw.fin-ntruss.com/ncr/api
HTTP

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-Type Required 요청 데이터의 형식
  • application/json

공통 응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
200 - OK 요청 성공
201 - OK 요청 성공
204 - OK 요청 성공
400 - Bad Request HTTPS 프로토콜이나 UTF-8 인코딩으로 인한 요청 오류
401 - Unauthorized 요청한 리소스를 사용하기 위한 인증 정보가 제공되지 않았거나 유효하지 않음
403 - Forbidden 요청한 리소스에 대한 권한이 없음
404 - Not Found 요청한 리소스를 찾을 수 없음
409 - Conflict 요청을 처리하는 동안 충돌 발생
500 - Internal Server Error 서버 오류
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

Container Registry 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
레지스트리 목록 조회 Container Registry에 등록된 레지스트리 목록 조회
신규 레지스트리 등록 Object Storage 버킷과 연동된 신규 레지스트리 등록
레지스트리 삭제 Container Registry에 등록된 레지스트리 삭제
이미지 목록 조회 Container Registry의 레지스트리에 등록된 이미지 목록 조회
이미지 상세 정보 조회 Container Registry의 레지스트리에 등록된 이미지의 상세 정보 조회
이미지 정보 수정 Container Registry의 레지스트리에 등록된 이미지 설명 수정
이미지 삭제 Container Registry의 레지스트리에 등록된 이미지 삭제
이미지 태그 목록 조회 Container Registry의 레지스트리에 등록된 이미지의 태그 목록 조회
이미지 태그 상세 정보 조회 Container Registry의 레지스트리에 등록된 이미지의 태그 정보 조회
이미지 태그 삭제 Container Registry의 레지스트리에 등록된 이미지의 태그 삭제

Container Registry API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.