Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-fast-launch-images

Описание

Описывает детали образов Windows AMI, настроенных для быстрого запуска Windows.

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

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

Синтаксис

  describe-fast-launch-images
[--image-ids <value>]
[--filters <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--image-ids (список)

Укажите один или несколько идентификаторов образов изображений Windows AMI для запроса.

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Используйте следующие фильтры для оптимизации результатов.

  • resource-type — тип ресурса для предварительной подготовки.
  • owner-id — идентификатор владельца ресурса предварительной подготовки.
  • state — текущее состояние быстрого запуска для Windows AMI.

(структура)

Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как метки, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Дополнительную информацию см. в разделе «Перечисление и фильтрация с помощью командной строки и API» в Руководстве пользователя Amazon EC2.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.

(строка)

Сокращённый синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--dry-run | --no-dry-run (булево)

Проверяет, имеете ли вы необходимые разрешения для действия, не выполняя сам запрос, и возвращает ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

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

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

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

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

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

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

--no-sign-request (булево)

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

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

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Чтобы описать детали образов Windows AMI, настроенных для быстрого запуска

Следующий пример describe-fast-launch-images описывает детали каждого AMI в вашей учётной записи, настроенного для быстрого запуска, включая тип ресурса, настройки снимков, детали шаблона запуска, максимальное количество параллельных запусков, идентификатор владельца AMI, состояние конфигурации быстрого запуска, причину изменения состояния и время изменения состояния.

aws ec2 describe-fast-launch-images

Вывод:

{
    "FastLaunchImages": [
        {
            "ImageId": "ami-01234567890abcedf",
            "ResourceType": "snapshot",
            "SnapshotConfiguration": {},
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-01234567890abcedf",
                "LaunchTemplateName": "EC2FastLaunchDefaultResourceCreation-a8c6215d-94e6-441b-9272-dbd1f87b07e2",
                "Version": "1"
            },
            "MaxParallelLaunches": 6,
            "OwnerId": "0123456789123",
            "State": "enabled",
            "StateTransitionReason": "Client.UserInitiated",
            "StateTransitionTime": "2022-01-27T22:20:06.552000+00:00"
        }
    ]
}

Дополнительную информацию о настройке Windows AMI для быстрого запуска см. в разделе Настройка вашего AMI для быстрого запуска в Руководстве пользователя Amazon EC2.

Вывод

FastLaunchImages -> (список)

Коллекция сведений о включенных в Windows быстрозапускаемых образах, соответствующих заданным критериям.

(структура)

Описание сведений об образе Windows с включенным быстрозапуском Windows, соответствующем заданным критериям. Критерии определяются фильтрами действий DescribeFastLaunchImages.

ImageId -> (строка)

Идентификатор образа, который определяет образ Windows с включенным быстрозапуском.

ResourceType -> (строка)

Тип ресурса, который Amazon EC2 использует для предварительной подготовки AMI Windows. Поддерживаемые значения включают: snapshot .

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

Группа параметров, используемых для предварительной подготовки связанного AMI Windows с помощью снимков.

TargetResourceCount -> (целое число)

Количество предварительно подготовленных снимков, которые требуется сохранить для AMI Windows с включенным быстрозапуском.

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

Шаблон запуска, который использует AMI Windows с включенным быстрозапуском при запуске экземпляров Windows из предварительно подготовленных снимков.

LaunchTemplateId -> (строка)

Идентификатор шаблона запуска, который используется AMI для быстрого запуска Windows.

LaunchTemplateName -> (строка)

Название шаблона запуска, который использует AMI для быстрого запуска Windows.

Version -> (строка)

Версия шаблона запуска, который использует AMI для быстрого запуска Windows.

MaxParallelLaunches -> (целое число)

Максимальное количество экземпляров, которые Amazon EC2 может запустить одновременно для создания предварительно подготовленных снимков для быстрого запуска Windows.

OwnerId -> (строка)

Идентификатор владельца AMI Windows с включенным быстрозапуском.

State -> (строка)

Текущее состояние быстрого запуска Windows для указанного AMI Windows.

StateTransitionReason -> (строка)

Причина изменения состояния быстрого запуска Windows для AMI на текущее состояние.

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

Время изменения состояния быстрого запуска Windows для AMI на текущее состояние.

NextToken -> (строка)

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

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

Spec-Zone.ru

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