Spec-Zone.ru › AWS CLI v2

[ aws . ecr ]

describe-repositories

Описание

Описывает хранилища изображений в реестре.

См. также: Документацию API AWS

describe-repositories является постраничной операцией. Для получения всего набора результатов могут быть выпущены несколько вызовов API. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной загрузкой аргумент --query должен извлекать данные из результатов следующих выражений запроса: repositories

Синтаксис

  describe-repositories
[--registry-id <value>]
[--repository-names <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--registry-id (строка)

Идентификатор учетной записи Amazon Web Services, связанный с реестром, содержащим хранилища, которые необходимо описать. Если вы не указываете реестр, используется реестр по умолчанию.

--repository-names (список)

Список хранилищ, которые необходимо описать. Если этот параметр опущен, описываются все хранилища в реестре.

(строка)

Синтаксис:

"string" "string" ...

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания места начала постраничной загрузки. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения данных в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые необходимо вернуть в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной загрузки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команды и вернёт пример JSON-вывода для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладочную запись журнала.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию, проверяющее сертификаты SSL.

--no-paginate (логическое значение)

Отключить автоматическую постраничную загрузку. Если автоматическая постраничная загрузка отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для использования при фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из вашего файла с данными учетных записей.

--region (строка)

Регион для использования. Переопределяет параметры конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Данные учетной записи не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл с сертификатами CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для конфигурируемого cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры нужно адаптировать к правилам цитирования вашей консоли. См. Раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.

Для описания хранилищ в реестре

В этом примере описываются хранилища в реестре по умолчанию для учетной записи.

Команда:

aws ecr describe-repositories

Вывод:

{
    "repositories": [
        {
            "registryId": "012345678910",
            "repositoryName": "ubuntu",
            "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/ubuntu"
        },
        {
            "registryId": "012345678910",
            "repositoryName": "test",
            "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/test"
        }
    ]
}

Вывод

repositories -> (список)

Список объектов хранилищ, соответствующих допустимым хранилищам.

(структура)

Объект, представляющий хранилище.

repositoryArn -> (строка)

Amazon Resource Name (ARN), идентифицирующий хранилище. ARN содержит пространство имен arn:aws:ecr, за которым следуют регион хранилища, идентификатор учетной записи Amazon Web Services владельца хранилища, пространство имен хранилища и имя хранилища. Например, arn:aws:ecr:region:012345678910:repository-namespace/repository-name .

registryId -> (строка)

Идентификатор учетной записи Amazon Web Services, связанный с реестром, который содержит хранилище.

repositoryName -> (строка)

Имя хранилища.

repositoryUri -> (строка)

URI для хранилища. Вы можете использовать этот URI для операций push и pull с контейнерными изображениями.

createdAt -> (отметка времени)

Дата и время создания хранилища в формате даты JavaScript.

imageTagMutability -> (строка)

Настройка изменчивости тегов для хранилища.

imageScanningConfiguration -> (структура)

Настройка сканирования изображений для хранилища.

scanOnPush -> (логическое значение)

Настройка, определяющая, будут ли изображения сканироваться после отправки в хранилище. Если установлено значение true, изображения будут сканироваться после отправки. Если этот параметр не указан, он будет по умолчанию установлен на значение false, и изображения не будут сканироваться, пока сканирование не будет инициировано вручную с помощью API API_StartImageScan.

encryptionConfiguration -> (структура)

Настройка шифрования для хранилища. Она определяет, как содержимое хранилища шифруется при хранении.

encryptionType -> (строка)

Тип шифрования.

Если вы используете тип шифрования KMS, содержимое хранилища будет зашифровано с помощью серверного шифрования с использованием ключа Key Management Service, хранящегося в KMS. При использовании KMS для шифрования данных вы можете использовать управляемый Amazon Web Services ключ KMS для Amazon ECR или указать свой собственный созданный ключ KMS.

Если вы используете тип шифрования KMS_DSSE, содержимое хранилища будет зашифровано с использованием двух уровней шифрования с помощью серверного шифрования с ключом KMS Management Service, хранящимся в KMS. Аналогично типу шифрования KMS, вы можете использовать управляемый Amazon Web Services ключ KMS для Amazon ECR или указать свой собственный созданный ключ KMS.

Если вы используете тип шифрования AES256, Amazon ECR использует серверное шифрование с управляемыми Amazon S3 ключами шифрования, которое шифрует изображения в хранилище с помощью алгоритма шифрования AES256.

Дополнительную информацию см. в разделе «Шифрование Amazon ECR в режиме хранения» в Руководстве пользователя Amazon Elastic Container Registry.

kmsKey -> (строка)

Если вы используете тип шифрования KMS, укажите используемый ключ KMS для шифрования. Можно указать псевдоним, идентификатор ключа или полное ARN ключа KMS. Ключ должен существовать в том же регионе, что и хранилище. Если ключ не указан, будет использован управляемый Amazon Web Services ключ KMS по умолчанию для Amazon ECR.

nextToken -> (строка)

Значение nextToken для включения в последующий запрос DescribeRepositories. Когда результаты запроса DescribeRepositories превышают maxResults, это значение можно использовать для получения следующей страницы результатов. Это значение равно null, когда больше результатов для возврата нет.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API