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