View image tag list

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in Classic and VPC

View the tag list for an image registered in the registry of Container Registry.

Requests

The following describes the request format for the endpoint. The request format is as follows.

Method	URI
GET	/repositories/{registry}/{imageName}/tags

Request headers

For headers common to all Container Registry APIs, see Container Registry common headers.

Request path parameters

The following describes the parameters.

Field	Type	Required	Description
`registry`	String	Required	Name of the registry where the image for which you want to view the tag list is registered
`imageName`	String	Required	Name of the image to view the tag list for Need to use URI encoded values <Example> For `hello/world`, convert to `hello%2Fworld` and use it

Request query parameters

The following describes the parameters.

Field	Type	Required	Description
`page`	Number	Optional	Page number to view Enter a value greater than 0 for the page number
`pagesize`	Number	Optional	Size of the page to view Enter a value greater than 0 for the page size

Request example

The following is a sample request.

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}"

Responses

The following describes the response format.

Response syntax

The response syntax is as follows.

{
  "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"
      }
  ]
}

Response body

The following describes the response body.

Field	Type	Required	Description
`count`	Number	-	Total number of registries registered
`next`	Number	-	Number of the next page It returns null if there is no next page
`previous`	Number	-	Number of the previous page It returns null if there is no previous page
`result[].creator`	String	-	Image registrant ID
`result[].digest`	String	-	Unique identifier ID for the image
`result[].full_size`	Number	-	Tag size
`result[].id`	Number	-	Tag ID
`result[].image_id`	Number	-	Image ID
`result[].images[].architecture`	String	-	CPU architecture, such as `amd64` or `ppc64le`
`result[].image.[]created`	String	-	Image creation date It returns elapsed time in milliseconds since January 1, 1970 00:00:00 UTC
`result[].image[].digest`	String	-	Unique identifier ID for the image
`result[].image[].features`	String	-	Not used
`result[].images[].latest_pulled`	Number	-	Date and time of the most recent image pull
`result[].images[].mediaType`	String	-	MIME type for image formats <Example> vnd.docker.container.image.v1+json: This is an image defined by the Docker container, with image format version v1 and MIME type with data encoded in JSON format
`result[].image[].os`	String	-	Operating system, such as `linux` or `windows`
`result[].image[].os_features`	String	-	Not used
`result[].image[].os_version`	String	-	Not used
`result[].images[].size`	Number	-	Image size
`result[].images[].updated`	Number	-	Image modification date and time
`result[].images[].variant`	String	-	Variant value available for specific architectures
`result[].last_updated`	String	-	Last modification date of the image It returns elapsed time in milliseconds since January 1, 1970 00:00:00 UTC
`result[].last_updater`	String	-	Image registrant ID
`result[].name`	String	-	Tag name
`result[].repository`	Number	-	Registry ID
`result[].v2`	Boolean	-	Whether to apply the v2 spec for images

Response status codes

The following describes response status codes. For response status codes common to all Container Registry APIs, see Container Registry response status codes.

HTTP status code	Code	Message	Description
200	-	OK	Request succeeded
404	-	Not Found	Requested resource not found

Response example

The following is a sample response.

{
  "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
      }
  ]
}

Was this article helpful?

What's Next

View image tag details

Table of contents

Requests
Responses