이미지 태그 목록 조회
- 인쇄
- PDF
이미지 태그 목록 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
Container Registry의 레지스트리에 등록된 이미지의 태그(Tag) 목록을 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /repositories/{registry}/{imageName}/tags |
요청 헤더
Container Registry API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Container Registry 공통 헤더를 참조해 주십시오.
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
registry | String | Required | 태그 목록 조회 대상 이미지가 등록되어 있는 레지스트리 이름 |
imageName | String | Required | 태그 목록 조회 대상 이미지 이름
|
요청 쿼리 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
page | Number | Optional | 조회할 페이지 번호
|
pagesize | Number | Optional | 조회할 페이지 크기
|
요청 예시
요청 예시는 다음과 같습니다.
curl -X GET "https://ncr.apigw.ntruss.com/ncr/api/v2/repositories/{registry}/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 | - | 다음 페이지의 번호
|
previous | Number | - | 이전 페이지의 번호
|
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 | - | 이미지 생성일
|
result[].image[].digest | String | - | 이미지의 고유 식별 아이디 |
result[].image[].features | String | - | 사용하지 않음 |
result[].images[].latest_pulled | Number | - | 가장 최근에 이미지를 Pull한 일시 |
result[].images[].mediaType | String | - | 이미지 포맷 관련 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 | - | 이미지 최근 변경일
|
result[].last_updater | String | - | 이미지 등록자 아이디 |
result[].name | String | - | 태그 이름 |
result[].repository | Number | - | 레지스트리 아이디 |
result[].v2 | Boolean | - | 이미지에 대한 v2 스펙 적용 유무 |
응답 상태 코드
응답 상태 코드는 다음과 같습니다. Container Registry API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Container Registry 응답 상태 코드를 참조해 주십시오.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 200 | - | OK | 요청 성공 |
| 404 | - | Not Found | 요청한 리소스를 찾을 수 없음 |
응답 예시
응답 예시는 다음과 같습니다.
{
"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
}
]
}
이 문서가 도움이 되었습니까?