Get started
Yandex Container Registry

Container Registry API, REST: Image.get

Written by

Returns the specified Image resource.

To get the list of available Image resources, make a list request.

HTTP request

GET https://container-registry.api.cloud.yandex.net/container-registry/v1/images/{imageId}

Path parameters

Parameter Description
imageId

Required. ID of the Docker image resource to return.

To get the Docker image ID use a list request.

The maximum string length in characters is 50.

Response

HTTP Code: 200 - OK

{
  "id": "string",
  "name": "string",
  "digest": "string",
  "compressedSize": "string",
  "config": {
    "id": "string",
    "digest": "string",
    "size": "string",
    "urls": [
      "string"
    ]
  },
  "layers": [
    {
      "id": "string",
      "digest": "string",
      "size": "string",
      "urls": [
        "string"
      ]
    }
  ],
  "tags": [
    "string"
  ],
  "createdAt": "string"
}

An Image resource. For more information, see Docker image.

Field Description
id string

Output only. ID of the Docker image.
name string

Name of the Docker image. The name is unique within the registry.
digest string

Content-addressable identifier of the Docker image.
compressedSize string (int64)

Compressed size of the Docker image, specified in bytes.
config object

Configuration of the Docker image.

A Blob resource.
config.
id		 string

Output only. ID of the blob.
config.
digest		 string

Content-addressable identifier of the blob.
config.
size		 string (int64)

Size of the blob, specified in bytes.
config.
urls[]		 string

List of blob urls.
layers[] object

Layers of the Docker image.
layers[].
id		 string

Output only. ID of the blob.
layers[].
digest		 string

Content-addressable identifier of the blob.
layers[].
size		 string (int64)

Size of the blob, specified in bytes.
layers[].
urls[]		 string

List of blob urls.
tags[] string

Tags of the Docker image.

Each tag is unique within the repository.
createdAt string (date-time)

Output only. Creation timestamp in RFC3339 text format.

String in RFC3339 text format. The range of possible values is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).
In this article: