이미지 태그 목록 조회

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

Container Registry의 레지스트리에 등록된 이미지의 태그 목록을 조회합니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 쿼리 파라미터

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

필드	타입	필수 여부	설명
`page`	Number	Optional	조회할 페이지 번호 페이지 번호는 0보다 큰 값을 입력
`pagesize`	Number	Optional	조회할 페이지 크기 페이지 크기는 0보다 큰 값을 입력

요청 예시

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

curl -X GET "https://gov-ncr.apigw.gov-ntruss.com/ncr/kr/v2/repositories/{registry}/{imageName}/tags" 
-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}"

응답

응답 형식을 설명합니다.

응답 구문

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

{
  "count": "number",
  "next": "number",
  "previous": "number",
  "results": [
      {
          "creator": "string",
          "digest": "string",
          "full_size": "number",
          "id": "number",
          "image_id": "number",
          "images": [
              {
                  "architecture": "string",
                  "created": "number",
                  "digest": "string",
                  "features": "string",
                  "latest_pulled": "number",
                  "mediaType": "string",
                  "os": "string",
                  "os_features": "string",
                  "os_version": "string",
                  "size": "number",
                  "updated": "number",
                  "variant": "string"
              }
          ],
          "last_updated": "number",
          "last_updater": "string",
          "name": "string",
          "repository": "number",
          "v2": "boolean"
      }
  ]
}

응답 바디

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

필드	타입	필수 여부	설명
`count`	Number	-	등록된 레지스트리의 총 개수
`next`	Number	-	다음 페이지의 번호 다음 페이지가 없다면 Null을 반환
`previous`	Number	-	이전 페이지의 번호 이전 페이지가 없다면 Null을 반환
`result[].creator`	String	-	이미지 등록자 아이디
`result[].digest`	String	-	이미지의 고유 식별 아이디
`result[].full_size`	Number	-	태그 사이즈
`result[].id`	Number	-	태그 아이디
`result[].image_id`	Number	-	이미지 아이디
`result[].images[].architecture`	String	-	`amd64` 혹은 `ppc64le`와 같은 CPU 아키텍처
`result[].image[].created`	String	-	이미지 생성일 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 반환
`result[].image[].digest`	String	-	이미지의 고유 식별 아이디
`result[].image[].features`	String	-	사용하지 않음
`result[].images[].latest_pulled`	Number	-	가장 최근에 이미지를 Pull한 일시
`result[].images[].mediaType`	String	-	이미지 포맷 관련 MIME 유형 <예시> vnd.docker.container.image.v1+json: 도커 컨테이너에서 정의한 이미지이며, 이미지 포맷 버전이 v1, 데이터가 JSON 포맷으로 인코딩된 MIME 유형
`result[].image[].os`	String	-	`linux` 혹은 `windows`와 같은 운영체제
`result[].image[].os_features`	String	-	사용하지 않음
`result[].image[].os_version`	String	-	사용하지 않음
`result[].images[].size`	Number	-	이미지 사이즈
`result[].images[].updated`	Number	-	이미지 수정 일시
`result[].images[].variant`	String	-	특정 아키텍처에 사용 가능한 변형 값
`result[].last_updated`	String	-	이미지 최근 변경일 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 반환
`result[].last_updater`	String	-	이미지 등록자 아이디
`result[].name`	String	-	태그 이름
`result[].repository`	Number	-	레지스트리 아이디
`result[].v2`	Boolean	-	이미지에 대한 v2 스펙 적용 유무

응답 상태 코드

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

응답 예시

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

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
      {
          "creator": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "digest": "sha256:a180 ~ b9dc",
          "full_size": 83518086,
          "id": 730606,
          "image_id": 322122,
          "images": [
              {
                  "architecture": "amd64",
                  "created": 1711928488000,
                  "digest": "sha256:sha256:a180 ~ b9dc",
                  "features": "",
                  "latest_pulled": 0,
                  "mediaType": "application/vnd.docker.container.image.v1+json",
                  "os": "linux",
                  "os_features": "",
                  "os_version": null,
                  "size": 83518086,
                  "updated": 1711928488000,
                  "variant": null
              }
          ],
          "last_updated": 1711928488000,
          "last_updater": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "name": "ncpdocker",
          "repository": 5976,
          "v2": true
      }
  ]
}