Метод list

Возвращает список доступных ресурсов Registry в указанном каталоге.

HTTP-запрос

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

Query-параметры

Параметр Описание
folderId Обязательное поле. Идентификатор каталога для получения списка реестров. Чтобы получить идентификатор каталога, используйте запрос list. Максимальная длина строки в символах — 50.
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Максимальное значение — 1000.
pageToken Токен страницы. Установите значение pageToken равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.
filter Параметры фильтрации ресурсов в ответе. В параметрах фильтрации указываются: 1. Имя поля. В настоящее время фильтрация осуществляется только по полю Registry.name. 2. Оператор. Может быть = или != для одиночных значений, IN или NOT IN для списков значений. 3. Значение или список значений для сравнения со значениями фильтра. Максимальная длина строки в символах — 1000.

Ответ

HTTP Code: 200 - OK

{
  "registries": [
    {
      "id": "string",
      "folderId": "string",
      "name": "string",
      "status": "string",
      "createdAt": "string",
      "labels": "object"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
registries[] object

Ресурс Registry. Подробнее смотрите в разделе Реестр.

registries[].
id
string

Только для вывода. Идентификатор реестра.

registries[].
folderId
string

Идентификатор каталога, которому принадлежит реестр.

registries[].
name
string

Название реестра.

registries[].
status
string

Только для вывода. Статус реестра.

  • CREATING: Реестр создается.
  • ACTIVE: Реестр готов к использованию.
  • DELETING: Реестр удаляется.
registries[].
createdAt
string (date-time)

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

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

registries[].
labels
object

Метки ресурса в формате key:value. Максимум 64 метки на ресурс.

nextPageToken string

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