Spec-Zone.ru › AWS CLI v2

[ aws . cloudformation ]

list-type-versions

Описание

Возвращает сводную информацию о версиях расширения.

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

Синтаксис

  list-type-versions
[--type <value>]
[--type-name <value>]
[--arn <value>]
[--max-results <value>]
[--next-token <value>]
[--deprecated-status <value>]
[--publisher-id <value>]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

--type (строка)

Тип расширения.

Условие: Вы должны указать либо TypeName и Type, либо Arn.

Возможные значения:

  • RESOURCE
  • MODULE
  • HOOK

--type-name (строка)

Имя расширения, для которого требуется сводная информация о версиях.

Условие: Вы должны указать либо TypeName и Type, либо Arn.

--arn (строка)

Amazon Resource Name (ARN) расширения, для которого требуется сводная информация о версиях.

Условие: Вы должны указать либо TypeName и Type, либо Arn.

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

Максимальное количество результатов, возвращаемых за один вызов. Если количество доступных результатов превышает это значение, ответ включает значение NextToken, которое можно назначить параметру запроса NextToken для получения следующего набора результатов.

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

Если предыдущий запрошенный набор результатов не вернул все оставшиеся результаты, значение параметра NextToken в объекте ответа установлено в маркер. Для получения следующего набора результатов вызовите этот метод снова и назначьте этот маркер параметру запроса NextToken. Если оставшихся результатов нет, значение параметра NextToken в предыдущем объекте ответа установлено в null.

--deprecated-status (строка)

Статус устаревания версий расширений, о которых требуется получить сводную информацию.

Допустимые значения включают:

  • LIVE: версия расширения зарегистрирована и может использоваться в операциях CloudFormation, в зависимости от поведения развертывания и области видимости.
  • DEPRECATED: версия расширения была дезактивирована и больше не может использоваться в операциях CloudFormation.

По умолчанию используется LIVE.

Возможные значения:

  • LIVE
  • DEPRECATED

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

Идентификатор издателя расширения.

Расширения, опубликованные Amazon, не имеют идентификатора издателя.

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

--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
  • текст
  • таблица
  • 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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, соответствующего двоичным данным, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для конфигурируемого cli-binary-format.

  • base64
  • raw-in-base64-out

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

Отключение постраничной навигации для вывода.

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

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

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

Отключение автоматического запроса входных параметров CLI.

Примеры

Примечание

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

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

Для перечисления версий расширения

Следующий list-type-versions пример возвращает сводную информацию о версиях расширения.

aws cloudformation list-type-versions \
  --endpoint https://example.com \
  --region us-west-2 \
  --type RESOURCE \
  --type-name My::Resource::Example \
  --publisher-id 123456789012

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Использование реестра AWS CloudFormation в Руководстве пользователя AWS CloudFormation.

Вывод

TypeVersionSummaries -> (список)

Список структур TypeVersionSummary, содержащих информацию о версиях указанного расширения.

(структура)

Содержит сводную информацию о конкретной версии расширения CloudFormation.

Type -> (строка)

Тип расширения.

TypeName -> (строка)

Имя расширения.

VersionId -> (строка)

Идентификатор конкретной версии расширения. Идентификатор версии — это значение в конце Amazon Resource Name (ARN), назначенное версии расширения при ее регистрации.

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

Указана ли данная версия расширения как версия по умолчанию.

Это относится только к частным расширениям, которые вы зарегистрировали в своей учетной записи, и к расширениям, опубликованным Amazon. Для общедоступных расширений сторонних разработчиков CloudFormation возвращает null.

Arn -> (строка)

Amazon Resource Name (ARN) версии расширения.

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

Дата регистрации версии.

Description -> (строка)

Описание версии расширения.

PublicVersionNumber -> (строка)

Для общедоступных расширений, активированных для этой учетной записи и региона, версия общедоступного расширения, используемая для операций CloudFormation в этой учетной записи и регионе. Для расширений, отличных от активированных расширений сторонних разработчиков, CloudFormation возвращает null.

Способ указания AutoUpdate при активации расширения влияет на то, автоматически ли CloudFormation обновляет расширение в этой учетной записи и регионе при выпуске новой версии. Дополнительную информацию см. в разделе Автоматическое использование новых версий расширений в Руководстве пользователя CloudFormation.

NextToken -> (строка)

Если запрос не возвращает все оставшиеся результаты, NextToken устанавливается в маркер. Для получения следующего набора результатов вызовите этот метод снова и назначьте этот маркер параметру запроса NextToken. Если запрос возвращает все результаты, NextToken устанавливается в null.

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

Spec-Zone.ru

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