View image tag details

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in Classic and VPC

View specific tag information 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/{reference}

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 tag information is registered
`imageName`	String	Required	Name of the image to view tag information for Need to use URI encoded values <Example> For `hello/world`, convert to `hello%2Fworld` and use it
`reference`	String	Required	Tag name to view details on

Request example

The following is a sample request.

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

{
  "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
`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 values in architecture
`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.

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

Delete image tag

Table of contents

Requests
Responses