Подключиться
Yandex Container Registry

Метод list

Статья создана

Получает список ресурсов Image в указанном реестре или
репозитории.

HTTP-запрос

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

Query-параметры

Параметр Описание
registryId Идентификатор реестра для получения списка Docker-образов. registryId игнорируется, если в запросе указан repositoryName. Чтобы получить идентификатор реестра, используйте запрос list. Максимальная длина строки в символах — 50.
repositoryName Имя репозитория для получения списка Docker-образов. Чтобы получить имя репозитория, используйте list запрос. Значение должно соответствовать регулярному выражению ``
folderId Идентификатор каталога, для которого запрашивается список Docker-образов. folderId игнорируется, если в запросе есть repositoryName или registryId. Чтобы получить идентификатор каталога, используйте запрос list. Максимальная длина строки в символах — 50.
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Максимальное значение — 1000.
pageToken Токен страницы. Установите значение pageToken равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.
filter Параметры фильтрации ресурсов в ответе. В параметрах фильтрации указываются: 1. Имя поля. В настоящее время фильтрация осуществляется только по полю Image.name. 2. Оператор. Может быть = или != для одиночных значений, IN или NOT IN для списков значений. 3. Значение. Должно быть не более 256 символов и соответствовать регулярному выражению [a-z0-9]+(?:[._-][a-z0-9]+)*(/([a-z0-9]+(?:[._-][a-z0-9]+)*)). Максимальная длина строки в символах — 1000.
orderBy Максимальная длина строки в символах — 100.

Ответ

HTTP Code: 200 - OK

{
  "images": [
    {
      "id": "string",
      "name": "string",
      "digest": "string",
      "compressedSize": "string",
      "config": {
        "id": "string",
        "digest": "string",
        "size": "string"
      },
      "layers": [
        {
          "id": "string",
          "digest": "string",
          "size": "string"
        }
      ],
      "tags": [
        "string"
      ],
      "createdAt": "string"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
images[] object

Ресурс Image. Подробнее смотрите в разделе Docker-образ.
images[].
id		 string

Только для вывода. Идентификатор Docker-образа.
images[].
name		 string

Имя Docker-образа. Уникально в рамках реестра.
images[].
digest		 string

Контентный адрес Docker-образа.
images[].
compressedSize		 string (int64)

Размер сжатого Docker-образа, в байтах.
images[].
config		 object

Конфигурация Docker-образа.

Ресурс Blob.
images[].
config.
id		 string

Только для вывода. Идентификатор блоба.
images[].
config.
digest		 string

Контентный адрес блоба.
images[].
config.
size		 string (int64)

Размер блоба, указанный в байтах.
images[].
layers[]		 object

Ресурс Blob.
images[].
layers[].
id		 string

Только для вывода. Идентификатор блоба.
images[].
layers[].
digest		 string

Контентный адрес блоба.
images[].
layers[].
size		 string (int64)

Размер блоба, указанный в байтах.
images[].
tags[]		 string

Теги Docker-образа.

Каждый тег уникален в пределах репозитория.
images[].
createdAt		 string (date-time)

Только для вывода. Время создания ресурса в формате RFC3339.

Строка в формате RFC3339.
nextPageToken string

Токен для получения следующей страницы результатов в ответе. Если количество результатов больше чем pageSize, используйте nextPageToken в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения nextPageToken для перебора страниц результатов.
В этой статье: