Get image tag details

Available in Classic and VPC

Get the tag information for an image registered in the registry of Container Registry.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/ncr/api/v2/repositories/{registry}/{imageName}/tags/{reference} (Korea Region)
GET	/ncr/sgn-api/v2/repositories/{registry}/{imageName}/tags/{reference} (Singapore Region)
GET	/ncr/jpn-api/v2/repositories/{registry}/{imageName}/tags/{reference} (Japan Region)

Request headers

For information about the headers common to all Container Registry APIs, see Container Registry request headers.

Request path parameters

You can use the following path parameters with your request:

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 request example is as follows:

curl -X GET 'https://ncr.apigw.ntruss.com/ncr/api/v2/repositories/{registry}/{imageName}/tags/{reference}' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

Response

This section 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 response body includes the following data:

Field	Type	Required	Description
`results`	Array	-	Response result: results

`results`

The following describes results.

Field	Type	Required	Description
`creator`	String	-	Image registrant ID
`digest`	String	-	Unique identifier ID for the image
`full_size`	Number	-	Tag size
`id`	Number	-	Tag ID
`image_id`	Number	-	Image ID
`images`	Array	-	Image information: images
`last_updated`	String	-	Last modification date of the image Return the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
`last_updater`	String	-	Image registrant ID
`name`	String	-	Tag name
`repository`	Number	-	Registry ID
`v2`	Boolean	-	Whether to apply the v2 spec for images

`images`

The following describes images.

Field	Type	Required	Description
`architecture`	String	-	CPU architecture, such as `amd64` or `ppc64le`
`created`	String	-	Image creation date Return the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
`digest`	String	-	Unique identifier ID for the image
`features`	String	-	Not used
`latest_pulled`	Number	-	Date and time of the most recent image pull
`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
`os`	String	-	Operating system, such as `linux` or `windows`
`os_features`	String	-	Not used
`os_version`	String	-	Not used
`size`	Number	-	Image size
`updated`	Number	-	Image modification date and time
`variant`	String	-	Variant values in architecture
`last_updated`	String	-	Last modification date of the image Return the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.

Response status codes

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

Response example

The response example is as follows:

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