Запрос на выполнение задания по выделению спотовых экземпляров

Описание

Ожидание, пока JMESPath-запрос SpotInstanceRequests[].Status.Code вернёт значение fulfilled для всех элементов при опросе с помощью describe-spot-instance-requests. Будет выполняться опрос каждые 15 секунд до достижения успешного состояния. Код возврата будет 255 после 40 неудачных проверок.

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

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

Синтаксис

  spot-instance-request-fulfilled
[--dry-run | --no-dry-run]
[--spot-instance-request-ids <value>]
[--filters <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]

Параметры

--dry-run | --no-dry-run (boolean)

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

--spot-instance-request-ids (список)

Идентификаторы запросов на спотовые экземпляры.

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Фильтры.

availability-zone-group — группа доступных зон.
create-time — отметка времени создания запроса на спотовый экземпляр.
fault-code — код ошибки, связанный с запросом.
fault-message — сообщение об ошибке, связанное с запросом.
instance-id — идентификатор экземпляра, выполнившего запрос.
launch-group — группа запуска спотовых экземпляров.
launch.block-device-mapping.delete-on-termination — указывает, будет ли объём EBS удалён при завершении работы экземпляра.
launch.block-device-mapping.device-name — имя устройства для привязки объёма в отображении блочных устройств (например, /dev/sdh или xvdh).
launch.block-device-mapping.snapshot-id — идентификатор снимка для объёма EBS.
launch.block-device-mapping.volume-size — размер объёма EBS в GiB.
launch.block-device-mapping.volume-type — тип объёма EBS: gp2 или gp3 для SSD общего назначения, io1 или io2 для SSD с предварительно заданным IOPS, st1 для HDD с оптимизированной пропускной способностью, sc1 для HDD холодного хранения или standard для магнитных.
launch.group-id — идентификатор группы безопасности для экземпляра.
launch.group-name — имя группы безопасности для экземпляра.
launch.image-id — идентификатор AMI.
launch.instance-type — тип экземпляра (например, m3.medium).
launch.kernel-id — идентификатор ядра.
launch.key-name — имя пары ключей, с которой запущен экземпляр.
launch.monitoring-enabled — включена ли подробная мониторинг для спотового экземпляра.
launch.ramdisk-id — идентификатор RAM-диска.
launched-availability-zone — доступная зона, в которой запущен запрос.
network-interface.addresses.primary — указывает, является ли IP-адрес основным частным IP-адресом.
network-interface.delete-on-termination — указывает, будет ли сетевой интерфейс удалён при завершении работы экземпляра.
network-interface.description — описание сетевого интерфейса.
network-interface.device-index — индекс устройства для подключения сетевого интерфейса к экземпляру.
network-interface.group-id — идентификатор группы безопасности, связанной с сетевым интерфейсом.
network-interface.network-interface-id — идентификатор сетевого интерфейса.
network-interface.private-ip-address — основной частный IP-адрес сетевого интерфейса.
network-interface.subnet-id — идентификатор подсети для экземпляра.
product-description — описание продукта, связанного с экземпляром (Linux/UNIX | Windows).
spot-instance-request-id — идентификатор запроса на спотовый экземпляр.
spot-price — максимальная почасовая цена для любого спотового экземпляра, запущенного для выполнения запроса.
state — состояние запроса на спотовый экземпляр (open | active | closed | cancelled | failed). Информация о статусе запроса на спот может помочь отслеживать ваши запросы на Amazon EC2 Spot Instance. Подробнее см. в руководстве пользователя Amazon EC2 по статусу запросов на спот.
status-code — короткий код, описывающий последнее оценивание вашего запроса на спотовый экземпляр.
status-message — сообщение, поясняющее статус запроса на спотовый экземпляр.
tag:<key> — сочетание ключ/значение тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с определённым ключом, независимо от значения тега.
type — тип запроса на спотовый экземпляр (one-time | persistent).
valid-from — дата начала запроса.
valid-until — дата окончания запроса.

(структура)

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

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

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

Name -> (строка)

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

Values -> (список)

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

(строка)

Краткая форма синтаксиса:

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

Синтаксис JSON:

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

--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 CLI по постраничной обработке.

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

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

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

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

Общие параметры

--debug (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования для бинарных блоков. Формат по умолчанию — 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 (boolean)

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

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Для ожидания выполнения запроса на создание экземпляра Spot Instance

Следующий wait spot-instance-request-fulfilled пример приостанавливает и возобновляет выполнение только после подтверждения выполнения запроса на создание экземпляра Spot Instance в указанной зоне доступности. Вывода не будет.

aws ec2 wait spot-instance-request-fulfilled \
    --filters Name=launched-availability-zone,Values=us-east-1

Вывод

Нет