Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Container Registry
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Аутентифицироваться в Container Registry
    • Управление Docker-образом
      • Получить информацию об имеющихся Docker-образах
      • Создать Docker-образ
      • Загрузить Docker-образ в реестр
      • Скачать Docker-образ из реестра
      • Удалить Docker-образ из реестра
    • Управление реестром
      • Получить информацию об имеющихся реестрах
      • Создать реестр
      • Изменить реестр
      • Удалить реестр
    • Управление репозиторием
      • Получить информацию об имеющихся репозиториях
    • Управление политиками автоматического удаления Docker-образов
      • Получить информацию об имеющихся политиках удаления
      • Создать политику удаления
      • Изменить политику удаления
      • Сделать тестовый запуск политики удаления
      • Удалить политику удаления
    • Работа с ролями
      • Назначить роль
      • Просмотреть назначенные роли
      • Отозвать роль
  • Yandex Container Solution
  • Сценарии использования
    • Все сценарии
    • Запуск Docker-образа на виртуальной машине
    • Создание триггера с помощью Yandex Cloud Functions
  • Концепции
    • Обзор
    • Docker-образ
    • Реестр
    • Репозиторий
    • Политика автоматического удаления Docker-образов
    • Триггер Yandex Cloud Functions
    • Резервное копирование
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • ImageService
      • RegistryService
      • RepositoryService
      • OperationService
    • REST
      • Обзор
      • Image
        • Обзор
        • delete
        • get
        • list
      • Registry
        • Обзор
        • create
        • delete
        • get
        • list
        • update
      • Repository
        • Обзор
        • list
  • Решение проблем
  • Вопросы и ответы
  1. Справочник API
  2. REST
  3. Image
  4. list

Метод list

  • HTTP-запрос
  • Query-параметры
  • Ответ

Получает список ресурсов 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 для перебора страниц результатов.

В этой статье:
  • HTTP-запрос
  • Query-параметры
  • Ответ
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»