이미지 상세 정보 조회

Classic/VPC 환경에서 이용 가능합니다.

Container Registry의 레지스트리에 등록된 이미지의 상세 정보를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/repositories/{registry}/{imageName}

요청 헤더

Container Registry API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Container Registry 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`registry`	String	Required	정보 조회 대상 이미지가 등록되어 있는 레지스트리 이름
`imageName`	String	Required	상세 정보 조회 대상 이미지 이름 URI 인코딩 값을 사용해야 함 <예시> `hello/world`의 경우 `hello%2Fworld`로 변환하여 사용

요청 예시

요청 예시는 다음과 같습니다.

curl -X GET "https://gov-ncr.apigw.gov-ntruss.com/ncr/kr/v2/repositories/{registry}/{imageName}" 
-H "x-ncp-apigw-timestamp: {Timestamp}"
-H "x-ncp-iam-access-key: {Sub Account Access Key}"
-H "x-ncp-apigw-signature-v2: {API Gateway Signature}"

응답

응답 형식을 설명합니다.

응답 구문

응답 구문은 다음과 같습니다.

{
  "can_edit": "boolean",
  "description": "string",
  "full_description": "string",
  "is_automated": "boolean",
  "is_private": "boolean",
  "last_updated": "number",
  "name": "string",
  "namespace": "string",
  "private_id": "",
  "pull_count": "number",
  "repository_type": "string",
  "star_count": "number",
  "status": "number",
  "tag_mutability_enabled": true,
  "user": "string",
}

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`can_edit`	Boolean	-	사용하지 않음
`description`	String	-	이미지에 대한 short description
`full_description`	String	-	이미지에 대한 상세 description
`is_automated`	Boolean	-	사용하지 않음
`is_private`	Boolean	-	사용하지 않음
`last_update`	Number	-	이미지의 최근 변경일 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 반환
`name`	String	-	이미지 이름
`namespace`	String	-	레지스트리 이름
`private_id`	String	-	private 엔드 포인트의 아이디
`pull_count`	Number	-	이미지에 대한 총 Pull count 값
`repository_type`	String	-	사용하지 않음
`star_count`	Number	-	사용하지 않음
`status`	Number	-	사용하지 않음
`tag_mutability_enabled`	Boolean	-	Tag Mutability 설정 여부
`user`	String	-	사용하지 않음

응답 상태 코드

Container Registry API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Container Registry 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
  "can_edit": true,
  "description": "ncp docker",
  "full_description": "Naver Cloud Platform Docker",
  "is_automated": null,
  "is_private": null,
  "last_updated": 1711928488000,
  "name": "ncpdocker",
  "namespace": "ncpdocker",
  "private_id": "",
  "pull_count": 0,
  "repository_type": "image",
  "star_count": null,
  "status": 0,
  "tag_mutability_enabled": true,
  "user": null
}