Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

create-fleet

Описание

Создает флот EC2, содержащий конфигурационную информацию для экземпляров On-Demand и Spot. Экземпляры запускаются немедленно, если есть доступная мощность.

Один флот EC2 может включать несколько спецификаций запуска, которые различаются по типу экземпляра, AMI, зоне доступности или подсети.

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

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

Синтаксис

  create-fleet
[--dry-run | --no-dry-run]
[--client-token <value>]
[--spot-options <value>]
[--on-demand-options <value>]
[--excess-capacity-termination-policy <value>]
--launch-template-configs <value>
--target-capacity-specification <value>
[--terminate-instances-with-expiration | --no-terminate-instances-with-expiration]
[--type <value>]
[--valid-from<value>]
[--valid-until <value>]
[--replace-unhealthy-instances | --no-replace-unhealthy-instances]
[--tag-specifications <value>]
[--context <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]

Параметры

--dry-run | --no-dry-run (логическое значение)

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

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Если вы не указываете токен клиента, для обеспечения идемпотентности запроса используется случайный токен.

Дополнительную информацию см. в разделе Обеспечение идемпотентности.

--spot-options (структура)

Описывает конфигурацию экземпляров Spot в EC2 Fleet.

AllocationStrategy -> (строка)

Стратегия, определяющая, как распределить целевую емкость экземпляров Spot по пулам экземпляров Spot, указанным в конфигурации запуска EC2 Fleet. Дополнительную информацию см. в разделе Стратегии распределения экземпляров Spot в руководстве пользователя Amazon EC2.

price-capacity-optimized (рекомендуется)

EC2 Fleet определяет пулы с наибольшей доступностью емкости для количества запускаемых экземпляров. Это означает, что мы запросим экземпляры Spot из пулов, которые, по нашему мнению, имеют наименьший риск прерывания в ближайшее время. Затем EC2 Fleet запросит экземпляры Spot из самого дешевого из этих пулов.

capacity-optimized

EC2 Fleet определяет пулы с наибольшей доступностью емкости для количества запускаемых экземпляров. Это означает, что мы запросим экземпляры Spot из пулов, которые, по нашему мнению, имеют наименьший риск прерывания в ближайшее время. Чтобы некоторым типам экземпляров было предоставлено больше шансов на запуск в первую очередь, используйте capacity-optimized-prioritized. Установите приоритет для каждого типа экземпляра, используя параметр Priority для LaunchTemplateOverrides. Вы можете назначить один и тот же приоритет различным LaunchTemplateOverrides. EC2 реализует приоритеты в режиме наилучшего предоставления, но сначала оптимизирует емкость. capacity-optimized-prioritized поддерживается только в том случае, если ваш EC2 Fleet использует шаблон запуска. Обратите внимание, что если On-Demand AllocationStrategy установлен на значение prioritized, тот же приоритет применяется при выполнении On-Demand емкости.

diversified

EC2 Fleet запрашивает экземпляры из всех указанных вами пулов экземпляров Spot.

lowest-price (не рекомендуется)

Предупреждение

Мы не рекомендуем стратегию распределения lowest-price, так как она имеет наибольший риск прерывания ваших экземпляров Spot.

EC2 Fleet запрашивает экземпляры из пула экземпляров Spot с самой низкой ценой, имеющего доступную емкость. Если пул с самой низкой ценой не имеет доступной емкости, экземпляры Spot берутся из следующего пула с более низкой ценой, имеющего доступную емкость. Если пул исчерпает емкость, прежде чем выполнить ваш желаемый объем, EC2 Fleet продолжит выполнение вашего запроса, используя следующий пул с более низкой ценой. Чтобы гарантировать выполнение вашего желаемого объема, вы можете получить экземпляры Spot из нескольких пулов. Поскольку эта стратегия учитывает только цену экземпляра, а не доступность емкости, она может привести к высоким показателям прерывания.

По умолчанию: lowest-price

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

Стратегии управления вашими экземплярами Spot, которые подвергаются повышенному риску прерывания.

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

Стратегия, которая используется, когда Amazon EC2 передает сигнал о том, что ваш экземпляр Spot подвергается повышенному риску прерывания.

ReplacementStrategy -> (строка)

Стратегия замены. Доступна только для флетов типа maintain.

launch — EC2 Fleet запускает замещающий экземпляр Spot при получении уведомления о перебалансировке для существующего экземпляра Spot в флете. EC2 Fleet не завершает экземпляры, которые получают уведомление о перебалансировке. Вы можете завершить старые экземпляры или оставить их работающими. Вам будет взиматься плата за все экземпляры во время их работы.

launch-before-terminate — EC2 Fleet запускает замещающий экземпляр Spot при получении уведомления о перебалансировке для существующего экземпляра Spot в флете и затем, после указанной вами задержки (в TerminationDelay), завершает экземпляры, которые получили уведомление о перебалансировке.

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

Время (в секундах), которое Amazon EC2 ожидает перед завершением старого экземпляра Spot после запуска нового замещающего экземпляра Spot.

Требуется, когда ReplacementStrategy установлено на значение launch-before-terminate.

Недействительно, когда ReplacementStrategy установлено на значение launch.

Допустимые значения: Минимальное значение 120 секунды. Максимальное значение 7200 секунды.

InstanceInterruptionBehavior -> (строка)

Поведение при прерывании экземпляра Spot.

По умолчанию: terminate

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

Количество пулов экземпляров Spot, по которым распределять целевую емкость Spot. Поддерживается только при установке Spot AllocationStrategy на значение lowest-price. EC2 Fleet выбирает самые дешевые пулы Spot и равномерно распределяет целевую емкость Spot по количеству указанных вами пулов Spot.

Обратите внимание, что EC2 Fleet пытается извлечь экземпляры Spot из указанного количества пулов в режиме наилучшего предоставления. Если пул исчерпывает емкость Spot, прежде чем выполнить вашу целевую емкость, EC2 Fleet продолжит выполнение запроса, извлекая экземпляры из следующего самого дешевого пула. Чтобы гарантировать выполнение вашей целевой емкости, вы можете получить экземпляры Spot из более чем указанного количества пулов. Аналогично, если у большинства пулов нет емкости Spot, вы можете получить всю целевую емкость из меньшего количества пулов, чем указано.

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

Указывает, что флет использует один тип экземпляра для запуска всех экземпляров Spot в флете.

Поддерживается только для флетов типа instant.

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

Указывает, что флет запускает все экземпляры Spot в одной зоне доступности.

Поддерживается только для флетов типа instant.

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

Минимальная целевая емкость для экземпляров Spot в флете. Если этот минимальный объем не достигнут, экземпляры не запускаются.

Ограничения: Максимальное значение 1000. Поддерживается только для флетов типа instant.

Должно быть указано хотя бы одно из следующего: SingleAvailabilityZone | SingleInstanceType

MaxTotalPrice -> (строка)

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

Предупреждение

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

Примечание

Если ваш флет включает экземпляры типа T, настроенные как unlimited, и если их среднее использование ЦП превышает базовую загрузку, вам будет взиматься плата за излишки кредитов. MaxTotalPrice не учитывает излишки кредитов, и если вы используете излишки кредитов, ваша окончательная стоимость может быть выше указанной для MaxTotalPrice. Дополнительную информацию см. в разделе Излишки кредитов могут влечь за собой расходы в руководстве пользователя Amazon EC2.

Краткая синтаксическая запись:

AllocationStrategy=string,MaintenanceStrategies={CapacityRebalance={ReplacementStrategy=string,TerminationDelay=integer}},InstanceInterruptionBehavior=string,InstancePoolsToUseCount=integer,SingleInstanceType=boolean,SingleAvailabilityZone=boolean,MinTargetCapacity=integer,MaxTotalPrice=string

Синтаксис JSON:

{
  "AllocationStrategy": "lowest-price"|"diversified"|"capacity-optimized"|"capacity-optimized-prioritized"|"price-capacity-optimized",
  "MaintenanceStrategies": {
    "CapacityRebalance": {
      "ReplacementStrategy": "launch"|"launch-before-terminate",
      "TerminationDelay": integer
    }
  },
  "InstanceInterruptionBehavior": "hibernate"|"stop"|"terminate",
  "InstancePoolsToUseCount": integer,
  "SingleInstanceType": true|false,
  "SingleAvailabilityZone": true|false,
  "MinTargetCapacity": integer,
  "MaxTotalPrice": "string"
}

--on-demand-options (структура)

Описывает конфигурацию экземпляров On-Demand в EC2 Fleet.

AllocationStrategy -> (строка)

Стратегия, определяющая порядок использования перезаписей шаблонов запуска для выполнения емкости On-Demand.

lowest-price — EC2 Fleet использует цену для определения порядка, запуская экземпляр с самой низкой ценой в первую очередь.

prioritized — EC2 Fleet использует приоритет, который вы назначили каждой замене шаблона запуска, запуская экземпляры с наивысшим приоритетом в первую очередь.

По умолчанию: lowest-price

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

Стратегия использования неиспользованных резерваций емкости для выполнения емкости On-Demand.

Поддерживается только для флетов типа instant.

UsageStrategy -> (строка)

Указывает, использовать ли неиспользованные резервации емкости для выполнения емкости On-Demand.

Если вы укажете use-capacity-reservations-first, флет использует неиспользованные резервации емкости для выполнения емкости On-Demand до целевого объема емкости On-Demand. Если несколько пулов экземпляров имеют неиспользованные резервации емкости, применяется стратегия распределения On-Demand (lowest-price или prioritized). Если количество неиспользованных резерваций емкости меньше целевого объема On-Demand, оставшаяся целевая емкость On-Demand запускается в соответствии со стратегией распределения On-Demand (lowest-price или prioritized).

Если вы не укажете значение, флет выполнит емкость On-Demand в соответствии с выбранной стратегией распределения On-Demand.

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

Указывает, что флет использует один тип экземпляра для запуска всех экземпляров On-Demand в флете.

Поддерживается только для флетов типа instant.

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

Указывает, что флет запускает все экземпляры On-Demand в одной зоне доступности.

Поддерживается только для флетов типа instant.

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

Минимальная целевая емкость для экземпляров On-Demand в флете. Если этот минимальный объем не достигнут, экземпляры не запускаются.

Ограничения: Максимальное значение 1000. Поддерживается только для флетов типа instant.

Должно быть указано хотя бы одно из следующего: SingleAvailabilityZone | SingleInstanceType

MaxTotalPrice -> (строка)

Максимальная стоимость за час за экземпляры On-Demand, которую вы готовы заплатить.

Примечание

Если ваш флет включает экземпляры типа T, настроенные как unlimited, и если их среднее использование ЦП превышает базовую загрузку, вам будет взиматься плата за излишки кредитов. MaxTotalPrice не учитывает излишки кредитов, и если вы используете излишки кредитов, ваша окончательная стоимость может быть выше указанной для MaxTotalPrice. Дополнительную информацию см. в разделе Излишки кредитов могут влечь за собой расходы в руководстве пользователя Amazon EC2.

Краткая синтаксическая запись:

AllocationStrategy=string,CapacityReservationOptions={UsageStrategy=string},SingleInstanceType=boolean,SingleAvailabilityZone=boolean,MinTargetCapacity=integer,MaxTotalPrice=string

Синтаксис JSON:

{
  "AllocationStrategy": "lowest-price"|"prioritized",
  "CapacityReservationOptions": {
    "UsageStrategy": "use-capacity-reservations-first"
  },
  "SingleInstanceType": true|false,
  "SingleAvailabilityZone": true|false,
  "MinTargetCapacity": integer,
  "MaxTotalPrice": "string"
}

--excess-capacity-termination-policy (строка)

Указывает, следует ли завершать запущенные экземпляры, если общий целевой объём EC2 Fleet уменьшится ниже текущего размера EC2 Fleet.

Поддерживается только для флотов типа maintain.

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

  • no-termination
  • termination

--launch-template-configs (список)

Настройка для EC2 Fleet.

(структура)

Описание шаблона запуска и перезаписи.

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

Шаблон запуска, который нужно использовать. В запросе необходимо указать либо ID, либо имя шаблона запуска.

LaunchTemplateId -> (строка)

ID шаблона запуска.

Необходимо указать либо LaunchTemplateId, либо LaunchTemplateName, но не оба.

LaunchTemplateName -> (строка)

Имя шаблона запуска.

Необходимо указать либо LaunchTemplateName, либо LaunchTemplateId, но не оба.

Version -> (строка)

Номер версии шаблона запуска, $Latest или $Default. Необходимо указать значение, в противном случае запрос завершится ошибкой.

Если значение равно $Latest, Amazon EC2 использует последнюю версию шаблона запуска.

Если значение равно $Default, Amazon EC2 использует версию по умолчанию шаблона запуска.

Overrides -> (список)

Любые параметры, которые вы укажете, перезаписывают те же параметры в шаблоне запуска.

Для флотов типа request и maintain разрешено не более 300 элементов во всех шаблонах запуска.

(структура)

Описание перезаписей для шаблона запуска.

InstanceType -> (строка)

Тип экземпляра.

mac1.metal не поддерживается как перезапись шаблона запуска.

Примечание

Если вы укажете InstanceType, вы не можете указать InstanceRequirements.

MaxPrice -> (строка)

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

Предупреждение

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

Если вы укажете максимальную цену, она должна быть больше 0,001 USD. Указание значения ниже 0,001 USD приведет к сообщению об ошибке InvalidParameterValue.

SubnetId -> (строка)

Идентификаторы подсетей, в которых необходимо запустить экземпляры. Несколько идентификаторов подсетей разделяйте запятыми (например, subnet-1234abcdeexample1, subnet-0987cdef6example2). В запросе типа instant может быть только один идентификатор подсети.

AvailabilityZone -> (строка)

Зона доступности, в которой необходимо запустить экземпляры.

WeightedCapacity -> (число с плавающей запятой)

Количество единиц, предоставляемых указанным типом экземпляра. Это те же единицы, которые вы выбрали для задания целевого объёма в терминах экземпляров или характеристики производительности, такие как vCPU, память или ввод/вывод.

Если целевой объём, деленный на это значение, не является целым числом, Amazon EC2 округляет число экземпляров до ближайшего целого числа. Если это значение не указано, значение по умолчанию равно 1.

Примечание

При указании весов цена, используемая в стратегиях распределения lowest-price и price-capacity-optimized, составляет за единицу часа (где цена экземпляра делится на указанный вес). Однако если все указанные веса превышают запрашиваемый TargetCapacity, в результате чего запускается только 1 экземпляр, цена используется за час работы экземпляра.

Priority -> (число с плавающей запятой)

Приоритет для перезаписи шаблона запуска. Наивысший приоритет запускается первым.

Если параметр On-Demand AllocationStrategy установлен в значение prioritized, EC2 Fleet использует приоритет, чтобы определить, какой шаблон перезаписи шаблона запуска использовать в первую очередь для выполнения задач On-Demand.

Если параметр Spot AllocationStrategy установлен в значение capacity-optimized-prioritized, EC2 Fleet использует приоритет на основе принципа «лучшее усилие» для определения шаблона перезаписи шаблона запуска, который следует использовать для выполнения задач Spot, но оптимизирует объём в первую очередь.

Допустимые значения — целые числа, начиная с 0. Чем меньше число, тем выше приоритет. Если число не задано, перезапись шаблона запуска имеет наименьший приоритет. Можно задать одинаковый приоритет для различных перезаписей шаблонов запуска.

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

Расположение, где запускается экземпляр, если применимо.

Affinity -> (строка)

Настройка сродства экземпляра на выделенном хосте.

Этот параметр не поддерживается для CreateFleet или ImportInstance.

GroupName -> (строка)

Имя группы размещения, в которой находится экземпляр. Если вы указываете GroupName, вы не можете указать GroupId.

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

Номер раздела, в котором находится экземпляр. Действительно только если стратегия размещения группы размещения установлена в partition.

Этот параметр не поддерживается для CreateFleet.

HostId -> (строка)

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

Этот параметр не поддерживается для CreateFleet или ImportInstance.

Tenancy -> (строка)

Тип аренды экземпляра. Экземпляр с арендой dedicated работает на оборудовании с арендой.

Этот параметр не поддерживается для CreateFleet. Аренда host не поддерживается для ImportInstance или для экземпляров T3, настроенных для опции кредита процессора unlimited.

SpreadDomain -> (строка)

Зарезервировано для будущего использования.

HostResourceGroupArn -> (строка)

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

Если вы указываете этот параметр, необходимо либо пропустить параметр Tenancy, либо установить его в значение host.

Этот параметр не поддерживается для CreateFleet.

GroupId -> (строка)

Идентификатор группы размещения, в которой находится экземпляр. Если вы указываете GroupId, вы не можете указать GroupName.

AvailabilityZone -> (строка)

Зона доступности экземпляра.

Если не указано, зона доступности будет автоматически выбрана на основе критериев балансировки нагрузки для региона.

Этот параметр не поддерживается для CreateFleet.

BlockDeviceMappings -> (список)

Отображения блочных устройств, определяющие EBS-тома и тома хранилища экземпляра, которые необходимо подключить к экземпляру при запуске.

Поддерживается только для флотов типа instant.

Для получения дополнительной информации см. Отображения блочных устройств для томов на экземплярах Amazon EC2 в руководстве пользователя Amazon EC2.

(структура)

Описывает отображение блочного устройства, которое определяет EBS-тома и тома хранилища экземпляра, которые необходимо подключить к экземпляру при запуске.

Для переопределения отображения блочного устройства, указанного в шаблоне запуска:

  • Укажите точно такой же DeviceName, как и в шаблоне запуска.
  • Указывайте только те параметры, которые хотите изменить.
  • Все параметры, которые не указаны здесь, сохранят свои значения из шаблона запуска.

Для добавления нового отображения блочного устройства:

  • Укажите DeviceName, которого нет в шаблоне запуска.
  • Укажите все необходимые параметры.

DeviceName -> (строка)

Имя устройства (например, /dev/sdh или xvdh).

VirtualName -> (строка)

Имя виртуального устройства (ephemeralN). Тома хранилища экземпляра нумеруются, начиная с 0. Тип экземпляра с 2 доступными томами хранилища экземпляра может указывать отображения для ephemeral0 и ephemeral1. Количество доступных томов хранилища экземпляра зависит от типа экземпляра. После подключения к экземпляру вы должны смонтировать том.

Тома хранилища экземпляра NVMe автоматически перечисляются и получают имя устройства. Включение их в отображение блочного устройства не оказывает никакого эффекта.

Ограничения: для экземпляров M3 вы должны указать тома хранилища экземпляра в отображении блочного устройства для экземпляра. При запуске экземпляра M3 мы игнорируем любые тома хранилища экземпляра, указанные в отображении блочного устройства для AMI.

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

Параметры, используемые для автоматической настройки EBS-томов при запуске экземпляра.

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

Указывает, изменяется ли состояние шифрования EBS-тома при восстановлении из резервной копии моментального снимка. Эффект установки состояния шифрования в true зависит от источника тома (новый или из моментального снимка), начального состояния шифрования, владения и включения шифрования по умолчанию. Для получения дополнительной информации см. Шифрование Amazon EBS в руководстве пользователя Amazon EBS.

В любом случае вы не можете удалить шифрование из зашифрованного тома.

Зашифрованные тома могут быть подключены только к экземплярам, которые поддерживают шифрование Amazon EBS. Для получения дополнительной информации см. Поддерживаемые типы экземпляров.

Этот параметр не возвращается операцией DescribeImageAttribute.

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

  • Если вы создаёте отображение блочного устройства для нового (пустого) тома, вы можете включить этот параметр и указать либо true для зашифрованного тома, либо false для незашифрованного тома. Если вы опустите этот параметр, он по умолчанию будет false (незашифрованный).
  • Если вы создаёте отображение блочного устройства из существующего зашифрованного или незашифрованного моментального снимка, вы должны опустить этот параметр. Если вы включите этот параметр, запрос завершится ошибкой независимо от указанного значения.
  • Если вы создаёте отображение блочного устройства из существующего незашифрованного тома, вы можете включить этот параметр, но вы должны указать false. Если вы укажете true, запрос завершится ошибкой. В этом случае рекомендуется опустить параметр.
  • Если вы создаёте отображение блочного устройства из существующего зашифрованного тома, вы можете включить этот параметр и указать либо true, либо false. Однако, если вы укажете false, параметр будет проигнорирован, и отображение блочного устройства всегда будет зашифровано. В этом случае рекомендуется опустить параметр.

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

Указывает, удаляется ли EBS-том при завершении работы экземпляра. Для получения дополнительной информации см. Сохранение данных при завершении работы экземпляра в руководстве пользователя Amazon EC2.

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

Количество операций ввода-вывода в секунду (IOPS). Для gp3, io1 и io2 томов это представляет количество IOPS, выделенных для тома. Для gp2 томов это представляет базовые характеристики производительности тома и скорость, с которой том накапливает кредиты I/O для увеличения производительности.

Ниже приведены допустимые значения для каждого типа тома:

  • gp3: 3000 - 16000 IOPS
  • io1: 100 - 64000 IOPS
  • io2: 100 - 256000 IOPS

Для io2 томов вы можете достичь до 256 000 IOPS на экземплярах, построенных на основе Nitro System. На других экземплярах вы можете достичь производительности до 32 000 IOPS.

Этот параметр необходим для io1 и io2 томов. По умолчанию для gp3 томов составляет 3000 IOPS.

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

Пропускная способность, которую поддерживает том, в MiB/с.

Этот параметр действителен только для gp3 томов.

Диапазон допустимых значений: от 125 до 1000.

KmsKeyId -> (строка)

Идентификатор (ID ключа, псевдоним ключа, ARN ключа или ARN псевдонима) управляемого пользователем KMS-ключа, который следует использовать для шифрования EBS.

Этот параметр поддерживается только для BlockDeviceMapping объектов, вызываемых CreateFleet, RequestSpotInstances и RunInstances.

SnapshotId -> (строка)

Идентификатор моментального снимка.

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

Размер тома в GiB. Вы должны указать либо ID моментального снимка, либо размер тома. Если вы указываете моментальный снимок, по умолчанию используется размер моментального снимка. Вы можете указать размер тома, равный или больший, чем размер моментального снимка.

Ниже приведены допустимые размеры для каждого типа тома:

  • gp2 и gp3: 1 - 16384 GiB
  • io1: 4 - 16384 GiB
  • io2: 4 - 65536 GiB
  • st1 и sc1: 125 - 16384 GiB
  • standard: 1 - 1024 GiB

VolumeType -> (строка)

Тип тома. Для получения дополнительной информации см. Типы томов Amazon EBS в руководстве пользователя Amazon EBS.

NoDevice -> (строка)

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

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

Атрибуты для типов экземпляров. При указании атрибутов экземпляров Amazon EC2 определит типы экземпляров с этими атрибутами.

Примечание

Если вы укажете InstanceRequirements, вы не сможете указать InstanceType.

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

Минимальное и максимальное количество виртуальных процессоров (vCPU).

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

Минимальное количество vCPU. Для указания отсутствия минимального ограничения, укажите 0.

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

Максимальное количество vCPU. Для указания отсутствия максимального ограничения, опустите этот параметр.

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

Минимальное и максимальное количество памяти в MiB.

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

Минимальное количество памяти в MiB. Для указания отсутствия минимального ограничения, укажите 0.

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

Максимальное количество памяти в MiB. Для указания отсутствия максимального ограничения, опустите этот параметр.

CpuManufacturers -> (список)

Производители ЦП для включения.

  • Для типов экземпляров с процессорами Intel, укажите intel.
  • Для типов экземпляров с процессорами AMD, укажите amd.
  • Для типов экземпляров с процессорами Amazon Web Services, укажите amazon-web-services.
  • Для типов экземпляров с процессорами Apple, укажите apple.

Примечание

Не путайте производителя ЦП с архитектурой ЦП. Экземпляры будут запущены с совместимой архитектурой ЦП на основе образа Amazon Machine Image (AMI), который вы укажете в вашей шаблоне запуска.

По умолчанию: Любой производитель

(строка)

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

Минимальное и максимальное количество памяти на vCPU в GiB.

По умолчанию: Без минимальных или максимальных ограничений

Min -> (двойное)

Минимальное количество памяти на vCPU в GiB. Для указания отсутствия минимального ограничения, опустите этот параметр.

Max -> (двойное)

Максимальное количество памяти на vCPU в GiB. Для указания отсутствия максимального ограничения, опустите этот параметр.

ExcludedInstanceTypes -> (список)

Типы экземпляров для исключения.

Вы можете использовать строки с одной или несколькими подстановками, представленными звездочкой (*), для исключения семейства, типа, размера или поколения экземпляров. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, Amazon EC2 исключит всё семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes, вы не сможете указать AllowedInstanceTypes.

По умолчанию: Без исключённых типов экземпляров

(строка)

InstanceGenerations -> (список)

Указывает, включаются ли типы экземпляров текущего или предыдущего поколения. Рекомендуется использовать типы экземпляров текущего поколения. Типы экземпляров текущего поколения, как правило, являются последними двумя-тремя поколениями в каждом семействе экземпляров. Для получения дополнительной информации см. Типы экземпляров в Руководстве пользователя Amazon EC2.

Для типов экземпляров текущего поколения, укажите current.

Для типов экземпляров предыдущего поколения, укажите previous.

По умолчанию: Типы экземпляров текущего и предыдущего поколения

(строка)

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

[Защита от цен] Порог защиты от цен для Spot-экземпляров, как процент, превышающий определённую цену Spot. Определённая цена Spot — это цена Spot самого дешёвого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то определённая цена Spot берется от самого дешёвого типа экземпляров текущего поколения, а в случае отсутствия — от самого дешёвого типа экземпляров предыдущего поколения, которые соответствуют вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами, типы экземпляров, цена Spot которых превышает заданный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы зададите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за vCPU или за память вместо цены за экземпляр.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту от цен, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, то есть вы хотите рассмотреть все типы экземпляров, которые соответствуют вашим атрибутам, включите один из этих параметров и укажите высокое значение, например 999999.

По умолчанию: 100

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

[Защита от цен] Порог защиты от цен для On-Demand экземпляров, как процент, превышающий определённую цену On-Demand. Определённая цена On-Demand — это цена самого дешёвого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. При выборе Amazon EC2 типов экземпляров с вашими атрибутами, типы экземпляров, цена которых превышает заданный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Чтобы указать отсутствие порога защиты от цен, укажите высокое значение, например 999999.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Если вы зададите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за vCPU или за память вместо цены за экземпляр.

По умолчанию: 20

BareMetal -> (строка)

Указывает, должны ли быть включены, исключены или обязательны типы экземпляров bare metal.

  • Для включения типов экземпляров bare metal, укажите included.
  • Для требования только типов экземпляров bare metal, укажите required.
  • Для исключения типов экземпляров bare metal, укажите excluded.

По умолчанию: excluded

BurstablePerformance -> (строка)

Указывает, включаются ли типы экземпляров T с производительностью burst, исключаются или требуются. Для получения дополнительной информации см. Экземпляры с производительностью burst.

  • Для включения типов экземпляров с производительностью burst, укажите included.
  • Для требования только типов экземпляров с производительностью burst, укажите required.
  • Для исключения типов экземпляров с производительностью burst, укажите excluded.

По умолчанию: excluded

RequireHibernateSupport -> (булево)

Указывает, должны ли типы экземпляров поддерживать приостановку для On-Demand экземпляров.

Этот параметр не поддерживается для GetSpotPlacementScores.

По умолчанию: false

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

Минимальное и максимальное количество сетевых интерфейсов.

По умолчанию: Без минимальных или максимальных ограничений

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

Минимальное количество сетевых интерфейсов. Для указания отсутствия минимального ограничения, опустите этот параметр.

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

Максимальное количество сетевых интерфейсов. Для указания отсутствия максимального ограничения, опустите этот параметр.

LocalStorage -> (строка)

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

  • Для включения типов экземпляров с томами хранилища экземпляра, укажите included.
  • Для требования только типов экземпляров с томами хранилища экземпляра, укажите required.
  • Для исключения типов экземпляров с томами хранилища экземпляра, укажите excluded.

По умолчанию: included

LocalStorageTypes -> (список)

Тип локального хранилища, который требуется.

  • Для типов экземпляров с хранилищем жестких дисков (HDD), укажите hdd.
  • Для типов экземпляров с хранилищем твердотельных дисков (SSD), укажите ssd.

По умолчанию: hdd и ssd

(строка)

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

Минимальное и максимальное количество общего локального хранилища в ГБ.

По умолчанию: Без минимальных или максимальных ограничений

Min -> (двойное)

Минимальное количество общего локального хранилища в ГБ. Для указания отсутствия минимального ограничения, опустите этот параметр.

Max -> (двойное)

Максимальное количество общего локального хранилища в ГБ. Для указания отсутствия максимального ограничения, опустите этот параметр.

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

Минимальная и максимальная базовая пропускная способность Amazon EBS в Мбит/с. Для получения дополнительной информации см. Оптимизированные экземпляры Amazon EBS в Руководстве пользователя Amazon EC2.

По умолчанию: Без минимальных или максимальных ограничений

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

Минимальная базовая пропускная способность в Мбит/с. Для указания отсутствия минимального ограничения, опустите этот параметр.

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

Максимальная базовая пропускная способность в Мбит/с. Для указания отсутствия максимального ограничения, опустите этот параметр.

AcceleratorTypes -> (список)

Типы ускорителей, которые должны быть на типе экземпляра.

  • Для типов экземпляров с ускорителями FPGA, укажите fpga.
  • Для типов экземпляров с ускорителями GPU, укажите gpu.
  • Для типов экземпляров с ускорителями Inference, укажите inference.

По умолчанию: Любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипы Amazon Web Services Inferentia) на экземпляре.

Для исключения типов экземпляров с поддержкой ускорителей, установите Max на 0.

По умолчанию: Без минимальных или максимальных ограничений

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

Минимальное количество ускорителей. Для указания отсутствия минимального ограничения, опустите этот параметр.

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

Максимальное количество ускорителей. Для указания отсутствия максимального ограничения, опустите этот параметр. Для исключения типов экземпляров с поддержкой ускорителей, установите Max на 0.

AcceleratorManufacturers -> (список)

Указывает, должны ли типы экземпляров иметь ускорители определенных производителей.

  • Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services .
  • Для типов экземпляров с устройствами AMD укажите amd .
  • Для типов экземпляров с устройствами Habana укажите habana .
  • Для типов экземпляров с устройствами NVIDIA укажите nvidia .
  • Для типов экземпляров с устройствами Xilinx укажите xilinx .

По умолчанию: Любой производитель

(строка)

AcceleratorNames -> (список)

Ускорители, которые должны быть на типе экземпляра.

  • Для типов экземпляров с графическими процессорами NVIDIA A10G укажите a10g .
  • Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100 .
  • Для типов экземпляров с графическими процессорами NVIDIA H100 укажите h100 .
  • Для типов экземпляров с чипами Amazon Web Services Inferentia укажите inferentia .
  • Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520 .
  • Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
  • Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
  • Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g .
  • Для типов экземпляров с FPGA Xilinx VU9P укажите vu9p .
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

По умолчанию: Любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти ускорителя в МБ.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальный объём памяти ускорителя в МБ. Чтобы не задавать минимальное ограничение, опустите этот параметр.

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

Максимальный объём памяти ускорителя в МБ. Чтобы не задавать максимальное ограничение, опустите этот параметр.

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

Минимальный и максимальный объём базовой пропускной способности сети в гигабитах в секунду (Гбит/с). Дополнительную информацию см. в руководстве пользователя Amazon EC2 по пропускной способности сети экземпляров Amazon EC2.

По умолчанию: Нет минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём пропускной способности сети в Гбит/с. Чтобы не задавать минимальное ограничение, опустите этот параметр.

Max -> (вещественное число)

Максимальный объём пропускной способности сети в Гбит/с. Чтобы не задавать максимальное ограничение, опустите этот параметр.

AllowedInstanceTypes -> (список)

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

Можно использовать строки с одним или несколькими символами подстановки, представленными звёздочкой (* ), чтобы разрешить тип, размер или поколение экземпляра. Вот несколько примеров: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажете c5* , Amazon EC2 разрешит весь семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.* , Amazon EC2 разрешит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете AllowedInstanceTypes , вы не можете указать ExcludedInstanceTypes .

По умолчанию: Все типы экземпляров

(строка)

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

[Защита цены] Пороговое значение цены защиты для Spot-экземпляров в процентах от определенной цены On-Demand. Определенная цена On-Demand — это цена самого дешевого экземпляра текущего поколения типа C, M или R с указанными атрибутами. Если ни один экземпляр текущего поколения типа C, M или R не соответствует вашим атрибутам, цена определяется по самому дешевому экземпляру текущего поколения, а затем, если это необходимо, по самому дешевому экземпляру предыдущего поколения, который соответствует вашим атрибутам. Когда Amazon EC2 выбирает типы экземпляров с вашими атрибутами, он исключает типы экземпляров, цена которых превышает указанный порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib , пороговое значение защиты цены основывается на цене за vCPU или память, а не на цене за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если ни один из них не указан, Amazon EC2 автоматически применит оптимальную защиту цены, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порогового значения защиты цены для Spot-экземпляров, то есть вы хотите учитывать все типы экземпляров, которые соответствуют вашим атрибутам, включите один из этих параметров и укажите большое значение, например, 999999 .

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

Базовые показатели производительности для рассмотрения, используя семейство экземпляров в качестве базовой точки отсчёта. Семейство экземпляров определяет наименьший приемлемый уровень производительности. Amazon EC2 использует эту базу для выбора типов экземпляров, но нет гарантии, что выбранные типы экземпляров всегда будут превосходить базовый уровень для каждого приложения. В настоящее время этот параметр поддерживает только производительность процессора как базовый показатель производительности. Дополнительную информацию см. в разделе Защита производительности в Руководстве пользователя Amazon EC2.

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

Производительность процессора для рассмотрения, используя семейство экземпляров в качестве базовой точки отсчёта.

References -> (список)

Укажите семейство экземпляров для использования в качестве базовой точки отсчёта для производительности процессора. Все типы экземпляров, которые соответствуют указанным вами атрибутам, будут сравниваться с производительностью процессора эталонного семейства экземпляров, независимо от различий в производителе процессора или архитектуре.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

(структура)

Укажите семейство экземпляров для использования в качестве базовой точки отсчёта для производительности процессора. Все типы экземпляров, которые соответствуют указанным вами атрибутам, будут сравниваться с производительностью процессора эталонного семейства экземпляров, независимо от производителя или архитектуры процессора.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

InstanceFamily -> (строка)

Семейство экземпляров для использования в качестве базовой точки отсчёта.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё, что находится перед точкой (. ) в имени типа экземпляра. Например, в типе экземпляра c6i.large семейством экземпляров является c6i , а не c6 . Дополнительную информацию см. в разделе Соглашения об именовании типов экземпляров Amazon EC2 в Типах экземпляров Amazon EC2.

Следующие семейства экземпляров не поддерживаются для защиты производительности:

  • c1
  • g3 | g3s
  • hpc7g
  • m1 | m2
  • mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
  • p3dn | p4d | p5
  • t1
  • u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров в качестве значения для базовой производительности, API вернёт пустой ответ для GetInstanceTypesFromInstanceRequirements и исключение для CreateFleet, RequestSpotFleet, ModifyFleet и ModifySpotFleetRequest.

ImageId -> (строка)

Идентификатор AMI в формате ami-17characters00000 .

В качестве альтернативы можно указать параметр Systems Manager, используя один из следующих форматов. Параметр Systems Manager будет преобразован в идентификатор AMI при запуске.

Для ссылки на общедоступный параметр:

  • ``resolve:ssm:public-parameter ``

Для ссылки на параметр, хранящийся в том же аккаунте:

  • ``resolve:ssm:parameter-name ``
  • ``resolve:ssm:parameter-name:version-number ``
  • ``resolve:ssm:parameter-name:label ``

Для ссылки на параметр, общий для другого аккаунта Amazon Web Services:

  • ``resolve:ssm:parameter-ARN ``
  • ``resolve:ssm:parameter-ARN:version-number ``
  • ``resolve:ssm:parameter-ARN:label ``

Дополнительную информацию см. в разделе Использование параметра Systems Manager вместо идентификатора AMI в Руководстве пользователя Amazon EC2.

Примечание

Этот параметр доступен только для флотов типа instant . Для флотов типа maintain и request необходимо указать идентификатор AMI в шаблоне запуска.

JSON Синтаксис:

[
  {
    "LaunchTemplateSpecification": {
      "LaunchTemplateId": "string",
      "LaunchTemplateName": "string",
      "Version": "string"
    },
    "Overrides": [
      {
        "InstanceType": "a1.medium"|"a1.large"|"a1.xlarge"|"a1.2xlarge"|"a1.4xlarge"|"a1.metal"|"c1.medium"|"c1.xlarge"|"c3.large"|"c3.xlarge"|"c3.2xlarge"|"c3.4xlarge"|"c3.8xlarge"|"c4.large"|"c4.xlarge"|"c4.2xlarge"|"c4.4xlarge"|"c4.8xlarge"|"c5.large"|"c5.xlarge"|"c5.2xlarge"|"c5.4xlarge"|"c5.9xlarge"|"c5.12xlarge"|"c5.18xlarge"|"c5.24xlarge"|"c5.metal"|"c5a.large"|"c5a.xlarge"|"c5a.2xlarge"|"c5a.4xlarge"|"c5a.8xlarge"|"c5a.12xlarge"|"c5a.16xlarge"|"c5a.24xlarge"|"c5ad.large"|"c5ad.xlarge"|"c5ad.2xlarge"|"c5ad.4xlarge"|"c5ad.8xlarge"|"c5ad.12xlarge"|"c5ad.16xlarge"|"c5ad.24xlarge"|"c5d.large"|"c5d.xlarge"|"c5d.2xlarge"|"c5d.4xlarge"|"c5d.9xlarge"|"c5d.12xlarge"|"c5d.18xlarge"|"c5d.24xlarge"|"c5d.metal"|"c5n.large"|"c5n.xlarge"|"c5n.2xlarge"|"c5n.4xlarge"|"c5n.9xlarge"|"c5n.18xlarge"|"c5n.metal"|"c6g.medium"|"c6g.large"|"c6g.xlarge"|"c6g.2xlarge"|"c6g.4xlarge"|"c6g.8xlarge"|"c6g.12xlarge"|"c6g.16xlarge"|"c6g.metal"|"c6gd.medium"|"c6gd.large"|"c6gd.xlarge"|"c6gd.2xlarge"|"c6gd.4xlarge"|"c6gd.8xlarge"|"c6gd.12xlarge"|"c6gd.16xlarge"|"c6gd.metal"|"c6gn.medium"|"c6gn.large"|"c6gn.xlarge"|"c6gn.2xlarge"|"c6gn.4xlarge"|"c6gn.8xlarge"|"c6gn.12xlarge"|"c6gn.16xlarge"|"c6i.large"|"c6i.xlarge"|"c6i.2xlarge"|"c6i.4xlarge"|"c6i.8xlarge"|"c6i.12xlarge"|"c6i.16xlarge"|"c6i.24xlarge"|"c6i.32xlarge"|"c6i.metal"|"cc1.4xlarge"|"cc2.8xlarge"|"cg1.4xlarge"|"cr1.8xlarge"|"d2.xlarge"|"d2.2xlarge"|"d2.4xlarge"|"d2.8xlarge"|"d3.xlarge"|"d3.2xlarge"|"d3.4xlarge"|"d3.8xlarge"|"d3en.xlarge"|"d3en.2xlarge"|"d3en.4xlarge"|"d3en.6xlarge"|"d3en.8xlarge"|"d3en.12xlarge"|"dl1.24xlarge"|"f1.2xlarge"|"f1.4xlarge"|"f1.16xlarge"|"g2.2xlarge"|"g2.8xlarge"|"g3.4xlarge"|"g3.8xlarge"|"g3.16xlarge"|"g3s.xlarge"|"g4ad.xlarge"|"g4ad.2xlarge"|"g4ad.4xlarge"|"g4ad.8xlarge"|"g4ad.16xlarge"|"g4dn.xlarge"|"g4dn.2xlarge"|"g4dn.4xlarge"|"g4dn.8xlarge"|"g4dn.12xlarge"|"g4dn.16xlarge"|"g4dn.metal"|"g5.xlarge"|"g5.2xlarge"|"g5.4xlarge"|"g5.8xlarge"|"g5.12xlarge"|"g5.16xlarge"|"g5.24xlarge"|"g5.48xlarge"|"g5g.xlarge"|"g5g.2xlarge"|"g5g.4xlarge"|"g5g.8xlarge"|"g5g.16xlarge"|"g5g.metal"|"hi1.4xlarge"|"hpc6a.48xlarge"|"hs1.8xlarge"|"h1.2xlarge"|"h1.4xlarge"|"h1.8xlarge"|"h1.16xlarge"|"i2.xlarge"|"i2.2xlarge"|"i2.4xlarge"|"i2.8xlarge"|"i3.large"|"i3.xlarge"|"i3.2xlarge"|"i3.4xlarge"|"i3.8xlarge"|"i3.16xlarge"|"i3.metal"|"i3en.large"|"i3en.xlarge"|"i3en.2xlarge"|"i3en.3xlarge"|"i3en.6xlarge"|"i3en.12xlarge"|"i3en.24xlarge"|"i3en.metal"|"im4gn.large"|"im4gn.xlarge"|"im4gn.2xlarge"|"im4gn.4xlarge"|"im4gn.8xlarge"|"im4gn.16xlarge"|"inf1.xlarge"|"inf1.2xlarge"|"inf1.6xlarge"|"inf1.24xlarge"|"is4gen.medium"|"is4gen.large"|"is4gen.xlarge"|"is4gen.2xlarge"|"is4gen.4xlarge"|"is4gen.8xlarge"|"m1.small"|"m1.medium"|"m1.large"|"m1.xlarge"|"m2.xlarge"|"m2.2xlarge"|"m2.4xlarge"|"m3.medium"|"m3.large"|"m3.xlarge"|"m3.2xlarge"|"m4.large"|"m4.xlarge"|"m4.2xlarge"|"m4.4xlarge"|"m4.10xlarge"|"m4.16xlarge"|"m5.large"|"m5.xlarge"|"m5.2xlarge"|"m5.4xlarge"|"m5.8xlarge"|"m5.12xlarge"|"m5.16xlarge"|"m5.24xlarge"|"m5.metal"|"m5a.large"|"m5a.xlarge"|"m5a.2xlarge"|"m5a.4xlarge"|"m5a.8xlarge"|"m5a.12xlarge"|"m5a.16xlarge"|"m5a.24xlarge"|"m5ad.large"|"m5ad.xlarge"|"m5ad.2xlarge"|"m5ad.4xlarge"|"m5ad.8xlarge"|"m5ad.12xlarge"|"m5ad.16xlarge"|"m5ad.24xlarge"|"m5d.large"|"m5d.xlarge"|"m5d.2xlarge"|"m5d.4xlarge"|"m5d.8xlarge"|"m5d.12xlarge"|"m5d.16xlarge"|"m5d.24xlarge"|"m5d.metal"|"m5dn.large"|"m5dn.xlarge"|"m5dn.2xlarge"|"m5dn.4xlarge"|"m5dn.8xlarge"|"m5dn.12xlarge"|"m5dn.16xlarge"|"m5dn.24xlarge"|"m5dn.metal"|"m5n.large"|"m5n.xlarge"|"m5n.2xlarge"|"m5n.4xlarge"|"m5n.8xlarge"|"m5n.12xlarge"|"m5n.16xlarge"|"m5n.24xlarge"|"m5n.metal"|"m5zn.large"|"m5zn.xlarge"|"m5zn.2xlarge"|"m5zn.3xlarge"|"m5zn.6xlarge"|"m5zn.12xlarge"|"m5zn.metal"|"m6a.large"|"m6a.xlarge"|"m6a.2xlarge"|"m6a.4xlarge"|"m6a.8xlarge"|"m6a.12xlarge"|"m6a.16xlarge"|"m6a.24xlarge"|"m6a.32xlarge"|"m6a.48xlarge"|"m6g.metal"|"m6g.medium"|"m6g.large"|"m6g.xlarge"|"m6g.2xlarge"|"m6g.4xlarge"|"m6g.8xlarge"|"m6g.12xlarge"|"m6g.16xlarge"|"m6gd.metal"|"m6gd.medium"|"m6gd.large"|"m6gd.xlarge"|"m6gd.2xlarge"|"m6gd.4xlarge"|"m6gd.8xlarge"|"m6gd.12xlarge"|"m6gd.16xlarge"|"m6i.large"|"m6i.xlarge"|"m6i.2xlarge"|"m6i.4xlarge"|"m6i.8xlarge"|"m6i.12xlarge"|"m6i.16xlarge"|"m6i.24xlarge"|"m6i.32xlarge"|"m6i.metal"|"mac1.metal"|"p2.xlarge"|"p2.8xlarge"|"p2.16xlarge"|"p3.2xlarge"|"p3.8xlarge"|"p3.16xlarge"|"p3dn.24xlarge"|"p4d.24xlarge"|"r3.large"|"r3.xlarge"|"r3.2xlarge"|"r3.4xlarge"|"r3.8xlarge"|"r4.large"|"r4.xlarge"|"r4.2xlarge"|"r4.4xlarge"|"r4.8xlarge"|"r4.16xlarge"|"r5.large"|"r5.xlarge"|"r5.2xlarge"|"r5.4xlarge"|"r5.8xlarge"|"r5.12xlarge"|"r5.16xlarge"|"r5.24xlarge"|"r5.metal"|"r5a.large"|"r5a.xlarge"|"r5a.2xlarge"|"r5a.4xlarge"|"r5a.8xlarge"|"r5a.12xlarge"|"r5a.16xlarge"|"r5a.24xlarge"|"r5ad.large"|"r5ad.xlarge"|"r5ad.2xlarge"|"r5ad.4xlarge"|"r5ad.8xlarge"|"r5ad.12xlarge"|"r5ad.16xlarge"|"r5ad.24xlarge"|"r5b.large"|"r5b.xlarge"|"r5b.2xlarge"|"r5b.4xlarge"|"r5b.8xlarge"|"r5b.12xlarge"|"r5b.16xlarge"|"r5b.24xlarge"|"r5b.metal"|"r5d.large"|"r5d.xlarge"|"r5d.2xlarge"|"r5d.4xlarge"|"r5d.8xlarge"|"r5d.12xlarge"|"r5d.16xlarge"|"r5d.24xlarge"|"r5d.metal"|"r5dn.large"|"r5dn.xlarge"|"r5dn.2xlarge"|"r5dn.4xlarge"|"r5dn.8xlarge"|"r5dn.12xlarge"|"r5dn.16xlarge"|"r5dn.24xlarge"|"r5dn.metal"|"r5n.large"|"r5n.xlarge"|"r5n.2xlarge"|"r5n.4xlarge"|"r5n.8xlarge"|"r5n.12xlarge"|"r5n.16xlarge"|"r5n.24xlarge"|"r5n.metal"|"r6g.medium"|"r6g.large"|"r6g.xlarge"|"r6g.2xlarge"|"r6g.4xlarge"|"r6g.8xlarge"|"r6g.12xlarge"|"r6g.16xlarge"|"r6g.metal"|"r6gd.medium"|"r6gd.large"|"r6gd.xlarge"|"r6gd.2xlarge"|"r6gd.4xlarge"|"r6gd.8xlarge"|"r6gd.12xlarge"|"r6gd.16xlarge"|"r6gd.metal"|"r6i.large"|"r6i.xlarge"|"r6i.2xlarge"|"r6i.4xlarge"|"r6i.8xlarge"|"r6i.12xlarge"|"r6i.16xlarge"|"r6i.24xlarge"|"r6i.32xlarge"|"r6i.metal"|"t1.micro"|"t2.nano"|"t2.micro"|"t2.small"|"t2.medium"|"t2.large"|"t2.xlarge"|"t2.2xlarge"|"t3.nano"|"t3.micro"|"t3.small"|"t3.medium"|"t3.large"|"t3.xlarge"|"t3.2xlarge"|"t3a.nano"|"t3a.micro"|"t3a.small"|"t3a.medium"|"t3a.large"|"t3a.xlarge"|"t3a.2xlarge"|"t4g.nano"|"t4g.micro"|"t4g.small"|"t4g.medium"|"t4g.large"|"t4g.xlarge"|"t4g.2xlarge"|"u-6tb1.56xlarge"|"u-6tb1.112xlarge"|"u-9tb1.112xlarge"|"u-12tb1.112xlarge"|"u-6tb1.metal"|"u-9tb1.metal"|"u-12tb1.metal"|"u-18tb1.metal"|"u-24tb1.metal"|"vt1.3xlarge"|"vt1.6xlarge"|"vt1.24xlarge"|"x1.16xlarge"|"x1.32xlarge"|"x1e.xlarge"|"x1e.2xlarge"|"x1e.4xlarge"|"x1e.8xlarge"|"x1e.16xlarge"|"x1e.32xlarge"|"x2iezn.2xlarge"|"x2iezn.4xlarge"|"x2iezn.6xlarge"|"x2iezn.8xlarge"|"x2iezn.12xlarge"|"x2iezn.metal"|"x2gd.medium"|"x2gd.large"|"x2gd.xlarge"|"x2gd.2xlarge"|"x2gd.4xlarge"|"x2gd.8xlarge"|"x2gd.12xlarge"|"x2gd.16xlarge"|"x2gd.metal"|"z1d.large"|"z1d.xlarge"|"z1d.2xlarge"|"z1d.3xlarge"|"z1d.6xlarge"|"z1d.12xlarge"|"z1d.metal"|"x2idn.16xlarge"|"x2idn.24xlarge"|"x2idn.32xlarge"|"x2iedn.xlarge"|"x2iedn.2xlarge"|"x2iedn.4xlarge"|"x2iedn.8xlarge"|"x2iedn.16xlarge"|"x2iedn.24xlarge"|"x2iedn.32xlarge"|"c6a.large"|"c6a.xlarge"|"c6a.2xlarge"|"c6a.4xlarge"|"c6a.8xlarge"|"c6a.12xlarge"|"c6a.16xlarge"|"c6a.24xlarge"|"c6a.32xlarge"|"c6a.48xlarge"|"c6a.metal"|"m6a.metal"|"i4i.large"|"i4i.xlarge"|"i4i.2xlarge"|"i4i.4xlarge"|"i4i.8xlarge"|"i4i.16xlarge"|"i4i.32xlarge"|"i4i.metal"|"x2idn.metal"|"x2iedn.metal"|"c7g.medium"|"c7g.large"|"c7g.xlarge"|"c7g.2xlarge"|"c7g.4xlarge"|"c7g.8xlarge"|"c7g.12xlarge"|"c7g.16xlarge"|"mac2.metal"|"c6id.large"|"c6id.xlarge"|"c6id.2xlarge"|"c6id.4xlarge"|"c6id.8xlarge"|"c6id.12xlarge"|"c6id.16xlarge"|"c6id.24xlarge"|"c6id.32xlarge"|"c6id.metal"|"m6id.large"|"m6id.xlarge"|"m6id.2xlarge"|"m6id.4xlarge"|"m6id.8xlarge"|"m6id.12xlarge"|"m6id.16xlarge"|"m6id.24xlarge"|"m6id.32xlarge"|"m6id.metal"|"r6id.large"|"r6id.xlarge"|"r6id.2xlarge"|"r6id.4xlarge"|"r6id.8xlarge"|"r6id.12xlarge"|"r6id.16xlarge"|"r6id.24xlarge"|"r6id.32xlarge"|"r6id.metal"|"r6a.large"|"r6a.xlarge"|"r6a.2xlarge"|"r6a.4xlarge"|"r6a.8xlarge"|"r6a.12xlarge"|"r6a.16xlarge"|"r6a.24xlarge"|"r6a.32xlarge"|"r6a.48xlarge"|"r6a.metal"|"p4de.24xlarge"|"u-3tb1.56xlarge"|"u-18tb1.112xlarge"|"u-24tb1.112xlarge"|"trn1.2xlarge"|"trn1.32xlarge"|"hpc6id.32xlarge"|"c6in.large"|"c6in.xlarge"|"c6in.2xlarge"|"c6in.4xlarge"|"c6in.8xlarge"|"c6in.12xlarge"|"c6in.16xlarge"|"c6in.24xlarge"|"c6in.32xlarge"|"m6in.large"|"m6in.xlarge"|"m6in.2xlarge"|"m6in.4xlarge"|"m6in.8xlarge"|"m6in.12xlarge"|"m6in.16xlarge"|"m6in.24xlarge"|"m6in.32xlarge"|"m6idn.large"|"m6idn.xlarge"|"m6idn.2xlarge"|"m6idn.4xlarge"|"m6idn.8xlarge"|"m6idn.12xlarge"|"m6idn.16xlarge"|"m6idn.24xlarge"|"m6idn.32xlarge"|"r6in.large"|"r6in.xlarge"|"r6in.2xlarge"|"r6in.4xlarge"|"r6in.8xlarge"|"r6in.12xlarge"|"r6in.16xlarge"|"r6in.24xlarge"|"r6in.32xlarge"|"r6idn.large"|"r6idn.xlarge"|"r6idn.2xlarge"|"r6idn.4xlarge"|"r6idn.8xlarge"|"r6idn.12xlarge"|"r6idn.16xlarge"|"r6idn.24xlarge"|"r6idn.32xlarge"|"c7g.metal"|"m7g.medium"|"m7g.large"|"m7g.xlarge"|"m7g.2xlarge"|"m7g.4xlarge"|"m7g.8xlarge"|"m7g.12xlarge"|"m7g.16xlarge"|"m7g.metal"|"r7g.medium"|"r7g.large"|"r7g.xlarge"|"r7g.2xlarge"|"r7g.4xlarge"|"r7g.8xlarge"|"r7g.12xlarge"|"r7g.16xlarge"|"r7g.metal"|"c6in.metal"|"m6in.metal"|"m6idn.metal"|"r6in.metal"|"r6idn.metal"|"inf2.xlarge"|"inf2.8xlarge"|"inf2.24xlarge"|"inf2.48xlarge"|"trn1n.32xlarge"|"i4g.large"|"i4g.xlarge"|"i4g.2xlarge"|"i4g.4xlarge"|"i4g.8xlarge"|"i4g.16xlarge"|"hpc7g.4xlarge"|"hpc7g.8xlarge"|"hpc7g.16xlarge"|"c7gn.medium"|"c7gn.large"|"c7gn.xlarge"|"c7gn.2xlarge"|"c7gn.4xlarge"|"c7gn.8xlarge"|"c7gn.12xlarge"|"c7gn.16xlarge"|"p5.48xlarge"|"m7i.large"|"m7i.xlarge"|"m7i.2xlarge"|"m7i.4xlarge"|"m7i.8xlarge"|"m7i.12xlarge"|"m7i.16xlarge"|"m7i.24xlarge"|"m7i.48xlarge"|"m7i-flex.large"|"m7i-flex.xlarge"|"m7i-flex.2xlarge"|"m7i-flex.4xlarge"|"m7i-flex.8xlarge"|"m7a.medium"|"m7a.large"|"m7a.xlarge"|"m7a.2xlarge"|"m7a.4xlarge"|"m7a.8xlarge"|"m7a.12xlarge"|"m7a.16xlarge"|"m7a.24xlarge"|"m7a.32xlarge"|"m7a.48xlarge"|"m7a.metal-48xl"|"hpc7a.12xlarge"|"hpc7a.24xlarge"|"hpc7a.48xlarge"|"hpc7a.96xlarge"|"c7gd.medium"|"c7gd.large"|"c7gd.xlarge"|"c7gd.2xlarge"|"c7gd.4xlarge"|"c7gd.8xlarge"|"c7gd.12xlarge"|"c7gd.16xlarge"|"m7gd.medium"|"m7gd.large"|"m7gd.xlarge"|"m7gd.2xlarge"|"m7gd.4xlarge"|"m7gd.8xlarge"|"m7gd.12xlarge"|"m7gd.16xlarge"|"r7gd.medium"|"r7gd.large"|"r7gd.xlarge"|"r7gd.2xlarge"|"r7gd.4xlarge"|"r7gd.8xlarge"|"r7gd.12xlarge"|"r7gd.16xlarge"|"r7a.medium"|"r7a.large"|"r7a.xlarge"|"r7a.2xlarge"|"r7a.4xlarge"|"r7a.8xlarge"|"r7a.12xlarge"|"r7a.16xlarge"|"r7a.24xlarge"|"r7a.32xlarge"|"r7a.48xlarge"|"c7i.large"|"c7i.xlarge"|"c7i.2xlarge"|"c7i.4xlarge"|"c7i.8xlarge"|"c7i.12xlarge"|"c7i.16xlarge"|"c7i.24xlarge"|"c7i.48xlarge"|"mac2-m2pro.metal"|"r7iz.large"|"r7iz.xlarge"|"r7iz.2xlarge"|"r7iz.4xlarge"|"r7iz.8xlarge"|"r7iz.12xlarge"|"r7iz.16xlarge"|"r7iz.32xlarge"|"c7a.medium"|"c7a.large"|"c7a.xlarge"|"c7a.2xlarge"|"c7a.4xlarge"|"c7a.8xlarge"|"c7a.12xlarge"|"c7a.16xlarge"|"c7a.24xlarge"|"c7a.32xlarge"|"c7a.48xlarge"|"c7a.metal-48xl"|"r7a.metal-48xl"|"r7i.large"|"r7i.xlarge"|"r7i.2xlarge"|"r7i.4xlarge"|"r7i.8xlarge"|"r7i.12xlarge"|"r7i.16xlarge"|"r7i.24xlarge"|"r7i.48xlarge"|"dl2q.24xlarge"|"mac2-m2.metal"|"i4i.12xlarge"|"i4i.24xlarge"|"c7i.metal-24xl"|"c7i.metal-48xl"|"m7i.metal-24xl"|"m7i.metal-48xl"|"r7i.metal-24xl"|"r7i.metal-48xl"|"r7iz.metal-16xl"|"r7iz.metal-32xl"|"c7gd.metal"|"m7gd.metal"|"r7gd.metal"|"g6.xlarge"|"g6.2xlarge"|"g6.4xlarge"|"g6.8xlarge"|"g6.12xlarge"|"g6.16xlarge"|"g6.24xlarge"|"g6.48xlarge"|"gr6.4xlarge"|"gr6.8xlarge"|"c7i-flex.large"|"c7i-flex.xlarge"|"c7i-flex.2xlarge"|"c7i-flex.4xlarge"|"c7i-flex.8xlarge"|"u7i-12tb.224xlarge"|"u7in-16tb.224xlarge"|"u7in-24tb.224xlarge"|"u7in-32tb.224xlarge"|"u7ib-12tb.224xlarge"|"c7gn.metal"|"r8g.medium"|"r8g.large"|"r8g.xlarge"|"r8g.2xlarge"|"r8g.4xlarge"|"r8g.8xlarge"|"r8g.12xlarge"|"r8g.16xlarge"|"r8g.24xlarge"|"r8g.48xlarge"|"r8g.metal-24xl"|"r8g.metal-48xl"|"mac2-m1ultra.metal"|"g6e.xlarge"|"g6e.2xlarge"|"g6e.4xlarge"|"g6e.8xlarge"|"g6e.12xlarge"|"g6e.16xlarge"|"g6e.24xlarge"|"g6e.48xlarge"|"c8g.medium"|"c8g.large"|"c8g.xlarge"|"c8g.2xlarge"|"c8g.4xlarge"|"c8g.8xlarge"|"c8g.12xlarge"|"c8g.16xlarge"|"c8g.24xlarge"|"c8g.48xlarge"|"c8g.metal-24xl"|"c8g.metal-48xl"|"m8g.medium"|"m8g.large"|"m8g.xlarge"|"m8g.2xlarge"|"m8g.4xlarge"|"m8g.8xlarge"|"m8g.12xlarge"|"m8g.16xlarge"|"m8g.24xlarge"|"m8g.48xlarge"|"m8g.metal-24xl"|"m8g.metal-48xl"|"x8g.medium"|"x8g.large"|"x8g.xlarge"|"x8g.2xlarge"|"x8g.4xlarge"|"x8g.8xlarge"|"x8g.12xlarge"|"x8g.16xlarge"|"x8g.24xlarge"|"x8g.48xlarge"|"x8g.metal-24xl"|"x8g.metal-48xl"|"i7ie.large"|"i7ie.xlarge"|"i7ie.2xlarge"|"i7ie.3xlarge"|"i7ie.6xlarge"|"i7ie.12xlarge"|"i7ie.18xlarge"|"i7ie.24xlarge"|"i7ie.48xlarge"|"i8g.large"|"i8g.xlarge"|"i8g.2xlarge"|"i8g.4xlarge"|"i8g.8xlarge"|"i8g.12xlarge"|"i8g.16xlarge"|"i8g.24xlarge"|"i8g.metal-24xl"|"u7i-6tb.112xlarge"|"u7i-8tb.112xlarge"|"u7inh-32tb.480xlarge"|"p5e.48xlarge"|"p5en.48xlarge"|"f2.12xlarge"|"f2.48xlarge"|"trn2.48xlarge"|"c7i-flex.12xlarge"|"c7i-flex.16xlarge"|"m7i-flex.12xlarge"|"m7i-flex.16xlarge"|"i7ie.metal-24xl"|"i7ie.metal-48xl"|"i8g.48xlarge"|"c8gd.medium"|"c8gd.large"|"c8gd.xlarge"|"c8gd.2xlarge"|"c8gd.4xlarge"|"c8gd.8xlarge"|"c8gd.12xlarge"|"c8gd.16xlarge"|"c8gd.24xlarge"|"c8gd.48xlarge"|"c8gd.metal-24xl"|"c8gd.metal-48xl"|"i7i.large"|"i7i.xlarge"|"i7i.2xlarge"|"i7i.4xlarge"|"i7i.8xlarge"|"i7i.12xlarge"|"i7i.16xlarge"|"i7i.24xlarge"|"i7i.48xlarge"|"i7i.metal-24xl"|"i7i.metal-48xl"|"p6-b200.48xlarge"|"m8gd.medium"|"m8gd.large"|"m8gd.xlarge"|"m8gd.2xlarge"|"m8gd.4xlarge"|"m8gd.8xlarge"|"m8gd.12xlarge"|"m8gd.16xlarge"|"m8gd.24xlarge"|"m8gd.48xlarge"|"m8gd.metal-24xl"|"m8gd.metal-48xl"|"r8gd.medium"|"r8gd.large"|"r8gd.xlarge"|"r8gd.2xlarge"|"r8gd.4xlarge"|"r8gd.8xlarge"|"r8gd.12xlarge"|"r8gd.16xlarge"|"r8gd.24xlarge"|"r8gd.48xlarge"|"r8gd.metal-24xl"|"r8gd.metal-48xl",
        "MaxPrice": "string",
        "SubnetId": "string",
        "AvailabilityZone": "string",
        "WeightedCapacity": double,
        "Priority": double,
        "Placement": {
          "Affinity": "string",
          "GroupName": "string",
          "PartitionNumber": integer,
          "HostId": "string",
          "Tenancy": "default"|"dedicated"|"host",
          "SpreadDomain": "string",
          "HostResourceGroupArn": "string",
          "GroupId": "string",
          "AvailabilityZone": "string"
        },
        "BlockDeviceMappings": [
          {
            "DeviceName": "string",
            "VirtualName": "string",
            "Ebs": {
              "Encrypted": true|false,
              "DeleteOnTermination": true|false,
              "Iops": integer,
              "Throughput": integer,
              "KmsKeyId": "string",
              "SnapshotId": "string",
              "VolumeSize": integer,
              "VolumeType": "standard"|"io1"|"io2"|"gp2"|"sc1"|"st1"|"gp3"
            },
            "NoDevice": "string"
          }
          ...
        ],
        "InstanceRequirements": {
          "VCpuCount": {
            "Min": integer,
            "Max": integer
          },
          "MemoryMiB": {
            "Min": integer,
            "Max": integer
          },
          "CpuManufacturers": ["intel"|"amd"|"amazon-web-services"|"apple", ...],
          "MemoryGiBPerVCpu": {
            "Min": double,
            "Max": double
          },
          "ExcludedInstanceTypes": ["string", ...],
          "InstanceGenerations": ["current"|"previous", ...],
          "SpotMaxPricePercentageOverLowestPrice": integer,
          "OnDemandMaxPricePercentageOverLowestPrice": integer,
          "BareMetal": "included"|"required"|"excluded",
          "BurstablePerformance": "included"|"required"|"excluded",
          "RequireHibernateSupport": true|false,
          "NetworkInterfaceCount": {
            "Min": integer,
            "Max": integer
          },
          "LocalStorage": "included"|"required"|"excluded",
          "LocalStorageTypes": ["hdd"|"ssd", ...],
          "TotalLocalStorageGB": {
            "Min": double,
            "Max": double
          },
          "BaselineEbsBandwidthMbps": {
            "Min": integer,
            "Max": integer
          },
          "AcceleratorTypes": ["gpu"|"fpga"|"inference", ...],
          "AcceleratorCount": {
            "Min": integer,
            "Max": integer
          },
          "AcceleratorManufacturers": ["amazon-web-services"|"amd"|"nvidia"|"xilinx"|"habana", ...],
          "AcceleratorNames": ["a100"|"inferentia"|"k520"|"k80"|"m60"|"radeon-pro-v520"|"t4"|"vu9p"|"v100"|"a10g"|"h100"|"t4g", ...],
          "AcceleratorTotalMemoryMiB": {
            "Min": integer,
            "Max": integer
          },
          "NetworkBandwidthGbps": {
            "Min": double,
            "Max": double
          },
          "AllowedInstanceTypes": ["string", ...],
          "MaxSpotPriceAsPercentageOfOptimalOnDemandPrice": integer,
          "BaselinePerformanceFactors": {
            "Cpu": {
              "References": [
                {
                  "InstanceFamily": "string"
                }
                ...
              ]
            }
          }
        },
        "ImageId": "string"
      }
      ...
    ]
  }
  ...
]

--target-capacity-specification (структура)

Количество единиц для запроса.

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

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

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

Количество On-Demand единиц для запроса.

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

Количество Spot единиц для запроса.

DefaultTargetCapacityType -> (строка)

Тип целевой ёмкости по умолчанию.

TargetCapacityUnitType -> (строка)

Единица для целевой ёмкости. Этот параметр можно указать только при использовании выбора типов экземпляров на основе атрибутов.

По умолчанию: units (количество экземпляров)

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

TotalTargetCapacity=integer,OnDemandTargetCapacity=integer,SpotTargetCapacity=integer,DefaultTargetCapacityType=string,TargetCapacityUnitType=string

JSON Синтаксис:

{
  "TotalTargetCapacity": integer,
  "OnDemandTargetCapacity": integer,
  "SpotTargetCapacity": integer,
  "DefaultTargetCapacityType": "spot"|"on-demand"|"capacity-block",
  "TargetCapacityUnitType": "vcpu"|"memory-mib"|"units"
}

--terminate-instances-with-expiration | --no-terminate-instances-with-expiration (boolean)

Указывает, должны ли завершаться запущенные экземпляры при истечении срока действия флота EC2.

--type (string)

Тип флота. Значение по умолчанию — maintain.

  • maintain — флот EC2 отправляет асинхронный запрос на требуемую емкость и продолжает поддерживать желаемую емкость Spot, восполняя прерванные экземпляры Spot.
  • request — флот EC2 отправляет асинхронный одноразовый запрос на требуемую емкость, но отправляет запросы Spot в альтернативные пулы емкости, если емкость Spot недоступна, и не поддерживает емкость Spot, если экземпляры Spot прерываются.
  • instant — флот EC2 отправляет синхронный одноразовый запрос на требуемую емкость и возвращает ошибки для всех экземпляров, которые не удалось запустить.

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

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

  • request
  • maintain
  • instant

--valid-from (timestamp)

Дата и время начала запроса в формате UTC (например, *YYYY*-*MM*-*DD* T*HH*: *MM*: *SS* Z). По умолчанию запрос выполняется немедленно.

--valid-until (timestamp)

Дата и время окончания запроса в формате UTC (например, *YYYY*-*MM*-*DD* T*HH*: *MM*: *SS* Z). В этот момент больше не выполняются новые запросы на флот EC2 или невозможно выполнить запрос. Если значение не указано, запрос остается активным до его отмены.

--replace-unhealthy-instances | --no-replace-unhealthy-instances (boolean)

Указывает, должен ли флот EC2 заменять неисправные экземпляры Spot. Поддерживается только для флотов типа maintain. Дополнительную информацию см. в разделе Проверка состояния флота EC2 в руководстве пользователя Amazon EC2.

--tag-specifications (list)

Пара ключевого значения для тегирования запроса флота EC2 при его создании. Дополнительную информацию см. в разделе Тегирование ваших ресурсов.

Если тип флота — instant, укажите тип ресурса fleet для тегирования флота или instance для тегирования экземпляров при запуске.

Если тип флота — maintain или request, укажите тип ресурса fleet для тегирования флота. Вы не можете указать тип ресурса instance. Чтобы тегировать экземпляры при запуске, укажите теги в шаблоне запуска.

(структура)

Теги, применяемые к ресурсу при его создании. При указании тега необходимо указать тип ресурса, иначе запрос завершится с ошибкой.

Примечание

Список Valid Values содержит все типы ресурсов, которые можно тегировать. Однако действие, которое вы используете, может не поддерживать тегирование всех этих типов ресурсов. Если вы попытаетесь тегировать тип ресурса, который не поддерживается для используемого действия, вы получите ошибку.

ResourceType -> (string)

Тип ресурса, который следует тегировать при создании.

Tags -> (list)

Теги, которые следует применить к ресурсу.

(структура)

Описание тега.

Key -> (string)

Ключ тега.

Ограничения: ключи тегов чувствительны к регистру и поддерживают максимум 127 символов Юникода. Не может начинаться с aws:.

Value -> (string)

Значение тега.

Ограничения: значения тегов чувствительны к регистру и поддерживают максимум 256 символов Юникода.

Сокращенная синтаксическая запись:

ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

--context (string)

Зарезервировано.

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

--generate-cli-skeleton (string) Вывод 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)

Файл с пакетом сертификатов CA для проверки сертификатов 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.

Пример 1: Создание EC2 флота, запускающего Spot-инстансы в качестве модели приобретения по умолчанию

Следующий create-fleet пример создает EC2 флот, используя минимальные необходимые параметры для запуска флота: шаблон запуска, целевую емкость и модель приобретения по умолчанию. Шаблон запуска определяется по его ID и номеру версии шаблона запуска. Целевая емкость флота составляет 2 инстанса, а модель приобретения по умолчанию — spot, что приводит к запуску флотом 2 Spot-инстансов.

При создании EC2 флота используйте JSON-файл для указания информации об инстансах, которые необходимо запустить.

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

Содержимое файла file_name.json:

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "DefaultTargetCapacityType": "spot"
    }
}

Вывод:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

Пример 2: Создание EC2 флота, запускающего инстансы On-Demand в качестве модели приобретения по умолчанию

Следующий create-fleet пример создает EC2 флот, используя минимальные необходимые параметры для запуска флота: шаблон запуска, целевую емкость и модель приобретения по умолчанию. Шаблон запуска определяется по его ID и номеру версии шаблона запуска. Целевая емкость флота составляет 2 инстанса, а модель приобретения по умолчанию — on-demand, что приводит к запуску флотом 2 инстансов On-Demand.

При создании EC2 флота используйте JSON-файл для указания информации об инстансах, которые необходимо запустить.

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

Содержимое файла file_name.json:

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
    "TotalTargetCapacity": 2,
    "DefaultTargetCapacityType": "on-demand"
    }
}

Вывод:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

Пример 3: Создание EC2 флота, запускающего инстансы On-Demand в качестве основной емкости

Следующий create-fleet пример создает EC2 флот, который определяет общую целевую емкость в 2 инстанса для флота и целевую емкость в 1 инстанс On-Demand. Модель приобретения по умолчанию — spot. Флот запускает 1 инстанс On-Demand, как указано, но ему необходимо запустить еще один инстанс, чтобы выполнить общую целевую емкость. Модель приобретения для разницы рассчитывается как TotalTargetCapacity - OnDemandTargetCapacity = DefaultTargetCapacityType, что приводит к запуску флотом 1 Spot-инстанса.

При создании EC2 флота используйте JSON-файл для указания информации об инстансах, которые необходимо запустить.

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

Содержимое файла file_name.json:

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "OnDemandTargetCapacity":1,
        "DefaultTargetCapacityType": "spot"
    }
}

Вывод:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

Пример 4: Создание EC2 флота, запускающего Spot-инстансы с использованием стратегии распределения по низкой цене

Если стратегия распределения для Spot-инстансов не указана, используется стратегия распределения по умолчанию, которая является lowest-price. Следующий create-fleet пример создает EC2 флот с использованием стратегии распределения lowest-price. Три спецификации запуска, которые переопределяют шаблон запуска, имеют разные типы инстансов, но одинаковую весовую емкость и подсеть. Общая целевая емкость составляет 2 инстанса, а модель приобретения по умолчанию — spot. EC2 флот запускает 2 Spot-инстанса, используя тип инстанса из спецификации запуска с самой низкой ценой.

При создании EC2 флота используйте JSON-файл для указания информации об инстансах, которые необходимо запустить.

aws ec2 create-fleet \
    --cli-input-json file://file_name.jsonContents of file_name.json::

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        },
        "Overrides": [
            {
                "InstanceType": "c4.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            },
            {
                "InstanceType": "c3.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            },
            {
                "InstanceType": "c5.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            }
        ]
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "DefaultTargetCapacityType": "spot"
    }
}

Вывод:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

Вывод

FleetId -> (строка)

Идентификатор EC2 флота.

Errors -> (список)

Информация об инстансах, которые не могут быть запущены флотом. Поддерживается только для флотов типа instant .

(структура)

Описание инстансов, которые не могут быть запущены флотом.

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

Шаблоны запуска и переопределения, которые использовались для запуска инстансов. Значения, которые вы указываете в Переопределениях, заменяют значения в шаблоне запуска.

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

Шаблон запуска.

LaunchTemplateId -> (строка)

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

Вы должны указать LaunchTemplateId или LaunchTemplateName, но не оба.

LaunchTemplateName -> (строка)

Имя шаблона запуска.

Вы должны указать LaunchTemplateName или LaunchTemplateId, но не оба.

Version -> (строка)

Номер версии шаблона запуска, $Latest или $Default. Вы должны указать значение, в противном случае запрос завершится ошибкой.

Если значение — $Latest, Amazon EC2 использует последнюю версию шаблона запуска.

Если значение — $Default, Amazon EC2 использует версию шаблона запуска по умолчанию.

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

Любые параметры, которые вы указываете, переопределяют те же параметры в шаблоне запуска.

InstanceType -> (строка)

Тип инстанса.

mac1.metal не поддерживается в качестве переопределения шаблона запуска.

Примечание

Если вы указываете InstanceType, вы не можете указать InstanceRequirements.

MaxPrice -> (строка)

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

Предупреждение

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

Если вы указываете максимальную цену, она должна быть больше 0,001 USD. Указание значения ниже 0,001 USD приведет к сообщению об ошибке InvalidParameterValue.

SubnetId -> (строка)

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

AvailabilityZone -> (строка)

Зона доступности, в которой нужно запустить инстансы.

WeightedCapacity -> (двойное)

Количество единиц, предоставляемых указанным типом инстанса. Это те же единицы, которые вы выбрали для задания целевой емкости в терминах инстансов или характеристики производительности, такой как vCPU, память или ввод/вывод.

Если целевая емкость, деленная на это значение, не является целым числом, Amazon EC2 округляет количество инстансов до ближайшего целого числа. Если это значение не указано, значение по умолчанию равно 1.

Примечание

При указании весов цена, используемая в стратегиях распределения lowest-price и price-capacity-optimized, составляет за единицу час (где цена инстанса делится на указанный вес). Однако, если все указанные веса выше запрошенной TargetCapacity, что приводит к запуску только 1 инстанса, используемая цена составляет за час работы инстанса.

Priority -> (двойное)

Приоритет для переопределения шаблона запуска. Наивысший приоритет запускается первым.

Если On-Demand AllocationStrategy установлен на prioritized, EC2 флот использует приоритет для определения того, какое переопределение шаблона запуска использовать первым для выполнения емкости On-Demand.

Если Spot AllocationStrategy установлен на capacity-optimized-prioritized, EC2 флот использует приоритет на основе наилучшего результата для определения того, какое переопределение шаблона запуска использовать для выполнения емкости Spot, но оптимизирует емкость в первую очередь.

Допустимые значения — целые числа, начиная с 0. Чем меньше число, тем выше приоритет. Если число не установлено, переопределение имеет самый низкий приоритет. Вы можете установить одинаковый приоритет для различных переопределений шаблонов запуска.

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

Расположение, где запущен инстанс, если применимо.

GroupName -> (строка)

Имя группы размещения, в которой находится инстанс.

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

Атрибуты для типов экземпляров. При указании атрибутов экземпляра Amazon EC2 определит типы экземпляров с этими атрибутами.

Примечание

Если вы укажете InstanceRequirements, вы не можете указать InstanceType.

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

Минимальное и максимальное количество vCPU.

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

Минимальное количество vCPU. Если значение равно 0, минимального ограничения нет.

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

Максимальное количество vCPU. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём памяти в MiB.

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

Минимальный объём памяти в MiB. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти в MiB. Если этот параметр не указан, максимального ограничения нет.

CpuManufacturers -> (список)

Производители процессоров для включения.

  • Для типов экземпляров с процессорами Intel укажите intel.
  • Для типов экземпляров с процессорами AMD укажите amd.
  • Для типов экземпляров с процессорами Amazon Web Services укажите amazon-web-services.
  • Для типов экземпляров с процессорами Apple укажите apple.

Примечание

Не путайте производителя процессора с архитектурой процессора. Экземпляры будут запущены с совместимой архитектурой процессора на основе образа Amazon Machine Image (AMI), который вы укажете в вашем шаблоне запуска.

По умолчанию: Любой производитель

(строка)

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

Минимальный и максимальный объём памяти на vCPU в GiB.

По умолчанию: Нет минимальных или максимальных ограничений

Min -> (двойное)

Минимальный объём памяти на vCPU в GiB. Если этот параметр не указан, минимального ограничения нет.

Max -> (двойное)

Максимальный объём памяти на vCPU в GiB. Если этот параметр не указан, максимального ограничения нет.

ExcludedInstanceTypes -> (список)

Типы экземпляров для исключения.

Вы можете использовать строки с одним или несколькими символами подстановки, представленными звездочкой (*), для исключения типа, размера или поколения экземпляра. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, Amazon EC2 исключит всю семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes, вы не можете указать AllowedInstanceTypes.

По умолчанию: Нет исключённых типов экземпляров

(строка)

InstanceGenerations -> (список)

Указывает, включаются ли типы экземпляров текущего или предыдущего поколения. Типы экземпляров текущего поколения рекомендуются для использования. Типы экземпляров текущего поколения, как правило, являются последними двумя-тремя поколениями в каждой семействе экземпляров. Дополнительную информацию см. в разделе Типы экземпляров в руководстве пользователя Amazon EC2.

Для типов экземпляров текущего поколения укажите current.

Для типов экземпляров предыдущего поколения укажите previous.

По умолчанию: Типы экземпляров текущего и предыдущего поколения

(строка)

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

[Защита от цен] Пороговое значение цены для Spot-экземпляров, как процент, превышающий идентифицированную цену Spot. Идентифицированная цена Spot — это цена Spot самого дешёвого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то идентифицированная цена Spot берётся от самого дешёвого типа экземпляров текущего поколения, а в случае неудачи — от самого дешёвого типа экземпляров предыдущего поколения, которые соответствуют вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами, типы экземпляров, цена Spot которых превышает указанный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за vCPU или за память вместо цены за экземпляр.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один, Amazon EC2 автоматически применит оптимальную защиту от цен, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, означающее, что вы хотите рассмотреть все типы экземпляров, которые соответствуют вашим атрибутам, включите один из этих параметров и укажите высокое значение, например, 999999.

По умолчанию: 100

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

[Защита от цен] Пороговое значение цены для экземпляров On-Demand, как процент, превышающий идентифицированную цену On-Demand. Идентифицированная цена On-Demand — это цена самого дешёвого типа экземпляра текущего поколения C, M или R с указанными вами атрибутами. При выборе Amazon EC2 типов экземпляров с вашими атрибутами, типы экземпляров, цена которых превышает указанный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Чтобы отключить защиту от цен, укажите высокое значение, например, 999999.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Если вы установите TargetCapacityUnitType на vcpu или memory-mib, порог защиты от цен применяется на основе цены за vCPU или за память вместо цены за экземпляр.

По умолчанию: 20

BareMetal -> (строка)

Указывает, должны ли быть включены, исключены или обязательны типы экземпляров bare metal.

  • Для включения типов экземпляров bare metal укажите included.
  • Для требования только типов экземпляров bare metal укажите required.
  • Для исключения типов экземпляров bare metal укажите excluded.

По умолчанию: excluded

BurstablePerformance -> (строка)

Указывает, включаются ли типы экземпляров T с повышенной производительностью, исключаются или требуются. Дополнительную информацию см. в разделе Экземпляры с повышенной производительностью.

  • Для включения типов экземпляров с повышенной производительностью укажите included.
  • Для требования только типов экземпляров с повышенной производительностью укажите required.
  • Для исключения типов экземпляров с повышенной производительностью укажите excluded.

По умолчанию: excluded

RequireHibernateSupport -> (булево)

Указывает, должны ли типы экземпляров поддерживать приостановку для экземпляров On-Demand.

Этот параметр не поддерживается для GetSpotPlacementScores.

По умолчанию: false

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

Минимальное и максимальное количество сетевых интерфейсов.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальное количество сетевых интерфейсов. Если этот параметр не указан, минимального ограничения нет.

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

Максимальное количество сетевых интерфейсов. Если этот параметр не указан, максимального ограничения нет.

LocalStorage -> (строка)

Указывает, включаются ли, исключаются или требуются типы экземпляров с томами хранилища экземпляра. Дополнительную информацию см. в разделе Хранилище экземпляра Amazon EC2 в руководстве пользователя Amazon EC2.

  • Для включения типов экземпляров с томами хранилища экземпляра укажите included.
  • Для требования только типов экземпляров с томами хранилища экземпляра укажите required.
  • Для исключения типов экземпляров с томами хранилища экземпляра укажите excluded.

По умолчанию: included

LocalStorageTypes -> (список)

Тип локального хранилища, который требуется.

  • Для типов экземпляров с хранилищем на жёстких дисках (HDD) укажите hdd.
  • Для типов экземпляров с твердотельным накопителем (SSD) укажите ssd.

По умолчанию: hdd и ssd

(строка)

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

Минимальный и максимальный объём общего локального хранилища в ГБ.

По умолчанию: Нет минимальных или максимальных ограничений

Min -> (двойное)

Минимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, минимального ограничения нет.

Max -> (двойное)

Максимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, максимального ограничения нет.

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

Минимальная и максимальная базовая пропускная способность Amazon EBS в Мбит/с. Дополнительную информацию см. в разделе Оптимизированные для Amazon EBS экземпляры в руководстве пользователя Amazon EC2.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, минимального ограничения нет.

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

Максимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, максимального ограничения нет.

AcceleratorTypes -> (список)

Типы ускорителей, которые должны быть на типе экземпляра.

  • Для типов экземпляров с FPGA-ускорителями укажите fpga.
  • Для типов экземпляров с GPU-ускорителями укажите gpu.
  • Для типов экземпляров с ускорителями Inference укажите inference.

По умолчанию: Любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипы Amazon Web Services Inferentia) на экземпляре.

Чтобы исключить типы экземпляров с поддержкой ускорителей, установите Max на 0.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальное количество ускорителей. Если этот параметр не указан, минимального ограничения нет.

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

Максимальное количество ускорителей. Если этот параметр не указан, максимального ограничения нет.

AcceleratorManufacturers -> (список)

Указывает, должны ли типы экземпляров иметь ускорители определенных производителей.

  • Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services .
  • Для типов экземпляров с устройствами AMD укажите amd .
  • Для типов экземпляров с устройствами Habana укажите habana .
  • Для типов экземпляров с устройствами NVIDIA укажите nvidia .
  • Для типов экземпляров с устройствами Xilinx укажите xilinx .

По умолчанию: Любой производитель

(строка)

AcceleratorNames -> (список)

Ускорители, которые должны быть на типе экземпляра.

  • Для типов экземпляров с графическими процессорами NVIDIA A10G укажите a10g .
  • Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100 .
  • Для типов экземпляров с графическими процессорами NVIDIA H100 укажите h100 .
  • Для типов экземпляров с чипами Inferentia Amazon Web Services укажите inferentia .
  • Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520 .
  • Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
  • Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
  • Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g .
  • Для типов экземпляров с FPGA Xilinx VU9P укажите vu9p .
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

По умолчанию: Любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти ускорителя в MiB.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальный объём памяти ускорителя в MiB. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти ускорителя в MiB. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

По умолчанию: Нет минимальных или максимальных ограничений

Min -> (двойное число)

Минимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, минимального ограничения нет.

Max -> (двойное число)

Максимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, максимального ограничения нет.

AllowedInstanceTypes -> (список)

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

Вы можете использовать строки с одним или несколькими символами подстановки, представленными звёздочкой (* ), чтобы разрешить тип, размер или поколение экземпляра. Ниже приведены примеры: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажите c5* , Amazon EC2 позволит всей семейству экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажите m5a.* , Amazon EC2 позволит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажите AllowedInstanceTypes , вы не можете указать ExcludedInstanceTypes .

По умолчанию: Все типы экземпляров

(строка)

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

[Защита от цен] Пороговое значение защиты от цен для Spot-экземпляров, выраженное в процентах от идентифицированной цены On-Demand. Идентифицированная цена On-Demand — это цена самого дешевого экземпляра текущего поколения C, M или R с вашими указанными атрибутами. Если ни один экземпляр текущего поколения C, M или R не соответствует вашим атрибутам, цена определяется по самому дешевому экземпляру текущего поколения, а если и это не подходит, по самому дешевому экземпляру предыдущего поколения, соответствующему вашим атрибутам. Когда Amazon EC2 выбирает типы экземпляров с вашими атрибутами, он исключит типы экземпляров, цена которых превышает указанный порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType на vcpu или memory-mib , порог защиты от цен будет основан на цене на vCPU или на объем памяти вместо цены за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если вы не укажете ни один из них, Amazon EC2 автоматически применит оптимальную защиту от цен, чтобы постоянно выбирать из широкого диапазона типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, то есть вы хотите рассмотреть все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например, 999999 .

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

Базовая производительность для рассмотрения, используя семейство экземпляров в качестве базовой ссылки. Семейство экземпляров устанавливает наименьший приемлемый уровень производительности. Amazon EC2 использует эту базу для руководства выбором типов экземпляров, но нет гарантии, что выбранные типы экземпляров всегда будут превышать базу для каждого приложения. В настоящее время этот параметр поддерживает только производительность процессора в качестве базового фактора производительности. Дополнительную информацию см. в разделе Защита производительности в руководстве пользователя Amazon EC2 .

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

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

References -> (список)

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

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

(структура)

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

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

InstanceFamily -> (строка)

Семейство экземпляров, используемое в качестве базовой ссылки.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё до точки (. ) в имени типа экземпляра. Например, в типе экземпляра c6i.large семейство экземпляров — это c6i , а не c6 . Дополнительную информацию см. в разделе Конвенции именования типов экземпляров Amazon EC2 в разделе «Типы экземпляров Amazon EC2» .

Следующие семейства экземпляров не поддерживаются для защиты производительности:

  • c1
  • g3 | g3s
  • hpc7g
  • m1 | m2
  • mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
  • p3dn | p4d | p5
  • t1
  • u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров как значение для базовой производительности, API возвращает пустой ответ для GetInstanceTypesFromInstanceRequirements и исключение для CreateFleet , RequestSpotFleet , ModifyFleet и ModifySpotFleetRequest .

ImageId -> (строка)

Идентификатор AMI в формате ami-17characters00000 .

В качестве альтернативы вы можете указать параметр Systems Manager, используя один из следующих форматов. Параметр Systems Manager будет разрешён до AMI ID при запуске.

Для ссылки на публичный параметр:

  • ``resolve:ssm:public-parameter ``

Для ссылки на параметр, хранящийся в том же аккаунте:

  • ``resolve:ssm:parameter-name ``
  • ``resolve:ssm:parameter-name:version-number ``
  • ``resolve:ssm:parameter-name:label ``

Для ссылки на параметр, общий для другого аккаунта Amazon Web Services:

  • ``resolve:ssm:parameter-ARN ``
  • ``resolve:ssm:parameter-ARN:version-number ``
  • ``resolve:ssm:parameter-ARN:label ``

Дополнительную информацию см. в разделе Использование параметра Systems Manager вместо идентификатора AMI в руководстве пользователя Amazon EC2 .

Примечание

Этот параметр доступен только для флотов типа instant . Для флотов типа maintain и request необходимо указать идентификатор AMI в шаблоне запуска.

BlockDeviceMappings -> (список)

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

Поддерживается только для флотов типа instant.

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

(структура)

Описывает сопоставление блочных устройств, определяющее тома EBS и тома памяти экземпляра, которые должны быть подключены к экземпляру при запуске.

DeviceName -> (строка)

Имя устройства (например, /dev/sdh или xvdh).

VirtualName -> (строка)

Имя виртуального устройства.

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

Параметры, используемые для автоматической настройки томов EBS при запуске экземпляра.

Encrypted -> (булево)

Указывает, зашифрован ли том.

DeleteOnTermination -> (булево)

Указывает, удаляется ли том при завершении работы экземпляра.

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

Количество операций ввода-вывода в секунду (IOPS). Для томов типов gp3, io1 и io2 это число IOPS, выделенное для тома. Для томов типа gp2 это базовая производительность тома и скорость накопления кредитов ввода-вывода для увеличения производительности.

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

Пропускная способность тома в MiB/с.

KmsKeyId -> (строка)

Идентификатор (ID ключа, псевдоним ключа, ARN ключа или ARN псевдонима) управляемого пользователем ключа KMS для использования в шифровании EBS.

SnapshotId -> (строка)

ID моментального снимка.

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

Размер тома в GiB.

VolumeType -> (строка)

Тип тома. Дополнительную информацию см. в разделе Типы томов Amazon EBS в руководстве пользователя Amazon EBS.

NoDevice -> (строка)

Запрещает указанное устройство, включенное в сопоставление блочных устройств.

Lifecycle -> (строка)

Указывает, был ли экземпляр, который не удалось запустить, экземпляром Spot или On-Demand.

ErrorCode -> (строка)

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

ErrorMessage -> (строка)

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

Instances -> (список)

Информация об экземплярах, запущенных флотом. Поддерживается только для флотов типа instant.

(структура)

Описывает экземпляры, запущенные флотом.

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

Используемые шаблоны запуска и переопределения параметров для запуска экземпляров. Значения, указанные в переопределениях, заменяют значения в шаблоне запуска.

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

Шаблон запуска.

LaunchTemplateId -> (строка)

ID шаблона запуска.

Необходимо указать LaunchTemplateId или LaunchTemplateName, но не оба.

LaunchTemplateName -> (строка)

Имя шаблона запуска.

Необходимо указать LaunchTemplateName или LaunchTemplateId, но не оба.

Version -> (строка)

Номер версии шаблона запуска, $Latest или $Default. Необходимо указать значение, иначе запрос завершится с ошибкой.

Если значение равно $Latest, Amazon EC2 использует последнюю версию шаблона запуска.

Если значение равно $Default, Amazon EC2 использует версию по умолчанию шаблона запуска.

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

Любые параметры, которые вы указываете, переопределяют те же параметры в шаблоне запуска.

InstanceType -> (строка)

Тип экземпляра.

mac1.metal не поддерживается в качестве переопределения шаблона запуска.

Примечание

Если вы укажете InstanceType, вы не можете указать InstanceRequirements.

MaxPrice -> (строка)

Максимальная цена за час работы экземпляра Spot. Не рекомендуется использовать этот параметр, так как он может привести к увеличению прерываний. Если этот параметр не указан, вы будете платить текущую цену Spot.

Предупреждение

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

Если вы укажете максимальную цену, она должна быть больше 0,001 USD. Указание значения ниже 0,001 USD приведет к сообщению об ошибке InvalidParameterValue.

SubnetId -> (строка)

ID подсети, в которой должны быть запущены экземпляры.

AvailabilityZone -> (строка)

Зона доступности, в которой должны быть запущены экземпляры.

WeightedCapacity -> (двойное число)

Количество единиц, предоставляемых указанным типом экземпляра. Это те же единицы, которые вы выбрали для задания целевой емкости в терминах экземпляров или характеристик производительности, таких как vCPU, память или ввод-вывод.

Если целевая емкость, деленная на это значение, не является целым числом, Amazon EC2 округляет количество экземпляров до ближайшего целого числа. Если это значение не указано, значение по умолчанию равно 1.

Примечание

При указании весов цена, используемая в стратегиях распределения lowest-price и price-capacity-optimized, рассчитывается за единицу часа (где цена экземпляра делится на указанный вес). Однако если все указанные веса превышают запрашиваемую емкость TargetCapacity, что приводит к запуску только 1 экземпляра, используется цена за экземпляр час.

Priority -> (двойное число)

Приоритет для переопределения шаблона запуска. Наивысший приоритет запускается в первую очередь.

Если параметр On-Demand AllocationStrategy установлен в значение prioritized, EC2 Fleet использует приоритет для определения шаблона запуска, который будет использоваться в первую очередь при выполнении емкости On-Demand.

Если параметр Spot AllocationStrategy установлен в значение capacity-optimized-prioritized, EC2 Fleet использует приоритет для определения шаблона запуска для выполнения емкости Spot, но оптимизирует емкость в первую очередь.

Допустимые значения — целые числа, начиная с 0. Чем меньше число, тем выше приоритет. Если число не установлено, переопределение имеет самый низкий приоритет. Вы можете установить одинаковый приоритет для разных переопределений шаблонов запуска.

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

Местоположение, где запущен экземпляр, если применимо.

GroupName -> (строка)

Имя группы размещения, в которой находится экземпляр.

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

Атрибуты для типов экземпляров. При указании атрибутов экземпляров Amazon EC2 определит типы экземпляров с этими атрибутами.

Примечание

Если вы укажете InstanceRequirements, вы не можете указать InstanceType.

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

Минимальное и максимальное количество vCPU.

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

Минимальное количество vCPU. Если значение равно 0, минимального ограничения нет.

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

Максимальное количество vCPU. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём памяти в MiB.

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

Минимальный объём памяти в MiB. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти в MiB. Если этот параметр не указан, максимального ограничения нет.

CpuManufacturers -> (список)

Производители процессоров, которые необходимо включить.

  • Для типов экземпляров с процессорами Intel укажите intel.
  • Для типов экземпляров с процессорами AMD укажите amd.
  • Для типов экземпляров с процессорами Amazon Web Services укажите amazon-web-services.
  • Для типов экземпляров с процессорами Apple укажите apple.

Примечание

Не путайте производителя процессора с архитектурой процессора. Экземпляры будут запущены с совместимой архитектурой процессора на основе образа Amazon Machine Image (AMI), который вы указали в шаблоне запуска.

По умолчанию: Любой производитель

(строка)

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

Минимальный и максимальный объём памяти на один vCPU в GiB.

По умолчанию: без минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём памяти на один vCPU в GiB. Если этот параметр не указан, минимального ограничения нет.

Max -> (вещественное число)

Максимальный объём памяти на один vCPU в GiB. Если этот параметр не указан, максимального ограничения нет.

ExcludedInstanceTypes -> (список)

Типы экземпляров, которые необходимо исключить.

Вы можете использовать строки с одной или несколькими подстановочными знаками, представленными звёздочкой (*), для исключения типа экземпляра, размера или поколения. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, Amazon EC2 исключит всю семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes, вы не можете указать AllowedInstanceTypes.

По умолчанию: нет исключённых типов экземпляров

(строка)

InstanceGenerations -> (список)

Указывает, включаются ли типы экземпляров текущего или предыдущего поколения. Для использования рекомендуются типы экземпляров текущего поколения. Типы экземпляров текущего поколения обычно являются последними двумя-тремя поколениями в каждой семействе экземпляров. Дополнительные сведения см. в разделе Типы экземпляров в руководстве пользователя Amazon EC2.

Для типов экземпляров текущего поколения укажите current.

Для типов экземпляров предыдущего поколения укажите previous.

По умолчанию: типы экземпляров текущего и предыдущего поколения

(строка)

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

[Защита от цены] Пороговое значение цены для Spot-экземпляров в процентах по отношению к самой низкой цене. Идентифицированная цена Spot - это цена Spot самого низкого по цене экземпляра текущего поколения C, M или R с указанными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то идентифицированная цена Spot взята от самого низкого по цене экземпляра текущего поколения, а затем, если и это не подходит, от самого низкого по цене экземпляра предыдущего поколения, который соответствует вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами типы экземпляров, цена Spot которых превышает указанный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType в vcpu или memory-mib, пороговое значение цены для защиты от неё применяется на основе цены за vCPU или за память, а не за экземпляр.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Можно указать только один из параметров SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если ни один из них не указан, Amazon EC2 автоматически применит оптимальную защиту от цены, чтобы последовательно выбирать из широкого диапазона типов экземпляров. Чтобы указать отсутствие порога цены для защиты от цен Spot-экземпляров, то есть вы хотите рассмотреть все типы экземпляров, которые соответствуют вашим атрибутам, укажите один из этих параметров и задайте высокое значение, например 999999.

По умолчанию: 100

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

[Защита от цены] Пороговое значение цены для экземпляров On-Demand в процентах по отношению к самой низкой цене On-Demand. Идентифицированная цена On-Demand - это цена самого низкого по цене экземпляра текущего поколения C, M или R с указанными вами атрибутами. При выборе Amazon EC2 типов экземпляров с вашими атрибутами типы экземпляров, цена которых превышает указанный вами порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Чтобы отключить защиту от цены, укажите высокое значение, например 999999.

Этот параметр не поддерживается для GetSpotPlacementScores и GetInstanceTypesFromInstanceRequirements.

Примечание

Если вы установите TargetCapacityUnitType в vcpu или memory-mib, пороговое значение цены для защиты от неё применяется на основе цены за vCPU или за память, а не за экземпляр.

По умолчанию: 20

BareMetal -> (строка)

Указывает, должны ли включаться, исключаться или быть обязательными типы экземпляров bare metal.

  • Для включения типов экземпляров bare metal укажите included.
  • Для того, чтобы требовались только типы экземпляров bare metal, укажите required.
  • Для исключения типов экземпляров bare metal укажите excluded.

По умолчанию: excluded

BurstablePerformance -> (строка)

Указывает, включаются ли, исключаются или требуются типы экземпляров T с повышенной производительностью. Дополнительные сведения см. в разделе Экземпляры с повышенной производительностью.

  • Для включения типов экземпляров с повышенной производительностью укажите included.
  • Для того, чтобы требовались только типы экземпляров с повышенной производительностью, укажите required.
  • Для исключения типов экземпляров с повышенной производительностью укажите excluded.

По умолчанию: excluded

RequireHibernateSupport -> (булево)

Указывает, должны ли типы экземпляров поддерживать приостановку для экземпляров On-Demand.

Этот параметр не поддерживается для GetSpotPlacementScores.

По умолчанию: false

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

Минимальное и максимальное количество сетевых интерфейсов.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальное количество сетевых интерфейсов. Если этот параметр не указан, минимального ограничения нет.

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

Максимальное количество сетевых интерфейсов. Если этот параметр не указан, максимального ограничения нет.

LocalStorage -> (строка)

Указывает, включаются ли, исключаются или требуются типы экземпляров с томами хранилища экземпляров. Дополнительные сведения о хранилище экземпляров Amazon EC2 см. в руководстве пользователя Amazon EC2.

  • Для включения типов экземпляров с томами хранилища экземпляров укажите included.
  • Для того, чтобы требовались только типы экземпляров с томами хранилища экземпляров, укажите required.
  • Для исключения типов экземпляров с томами хранилища экземпляров укажите excluded.

По умолчанию: included

LocalStorageTypes -> (список)

Требуемый тип локального хранилища.

  • Для типов экземпляров с дисками HDD укажите hdd.
  • Для типов экземпляров с дисками SSD укажите ssd.

По умолчанию: hdd и ssd

(строка)

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

Минимальный и максимальный объём общего локального хранилища в ГБ.

По умолчанию: без минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, минимального ограничения нет.

Max -> (вещественное число)

Максимальный объём общего локального хранилища в ГБ. Если этот параметр не указан, максимального ограничения нет.

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

Минимальная и максимальная базовая пропускная способность Amazon EBS в Мбит/с. Дополнительные сведения см. в разделе Экземпляры Amazon EBS в руководстве пользователя Amazon EC2.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, минимального ограничения нет.

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

Максимальная базовая пропускная способность в Мбит/с. Если этот параметр не указан, максимального ограничения нет.

AcceleratorTypes -> (список)

Типы ускорителей, которые должны быть на типе экземпляра.

  • Для типов экземпляров с ускорителями FPGA укажите fpga.
  • Для типов экземпляров с ускорителями GPU укажите gpu.
  • Для типов экземпляров с ускорителями Inference укажите inference.

По умолчанию: любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипы Amazon Web Services Inferentia) на экземпляре.

Чтобы исключить типы экземпляров с поддержкой ускорителей, установите Max в 0.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальное количество ускорителей. Если этот параметр не указан, минимального ограничения нет.

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

Максимальное количество ускорителей. Если этот параметр не указан, максимального ограничения нет.

AcceleratorManufacturers -> (список)

Указывает, должны ли типы экземпляров иметь ускорители определённых производителей.

  • Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services .
  • Для типов экземпляров с устройствами AMD укажите amd .
  • Для типов экземпляров с устройствами Habana укажите habana .
  • Для типов экземпляров с устройствами NVIDIA укажите nvidia .
  • Для типов экземпляров с устройствами Xilinx укажите xilinx .

По умолчанию: любой производитель

(строка)

AcceleratorNames -> (список)

Ускорители, которые должны быть на типе экземпляра.

  • Для типов экземпляров с графическими процессорами NVIDIA A10G укажите a10g .
  • Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100 .
  • Для типов экземпляров с графическими процессорами NVIDIA H100 укажите h100 .
  • Для типов экземпляров с чипами Inferentia от Amazon Web Services укажите inferentia .
  • Для типов экземпляров с графическими процессорами NVIDIA GRID K520 укажите k520 .
  • Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
  • Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
  • Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
  • Для типов экземпляров с графическими процессорами NVIDIA T4G укажите t4g .
  • Для типов экземпляров с программируемыми логическими чипами Xilinx VU9P укажите vu9p .
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

По умолчанию: любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти ускорителя в MiB.

По умолчанию: без минимальных или максимальных ограничений

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

Минимальный объём памяти ускорителя в MiB. Если этот параметр не указан, минимального ограничения нет.

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

Максимальный объём памяти ускорителя в MiB. Если этот параметр не указан, максимального ограничения нет.

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

Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

По умолчанию: без минимальных или максимальных ограничений

Min -> (двойное число)

Минимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, минимального ограничения нет.

Max -> (двойное число)

Максимальный объём пропускной способности сети в Gbps. Если этот параметр не указан, максимального ограничения нет.

AllowedInstanceTypes -> (список)

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

Можно использовать строки с одним или несколькими символами-подстановочными знаками, представленными звёздочкой (* ), чтобы разрешить тип, размер или поколение экземпляра. Ниже приведены примеры: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажете c5* , Amazon EC2 позволит использовать весь семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.* , Amazon EC2 позволит использовать все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете AllowedInstanceTypes , вы не можете указать ExcludedInstanceTypes .

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

(строка)

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

[Защита цены] Пороговое значение защиты цены для Spot-инстансов в процентах от идентифицированной цены On-Demand. Идентифицированная цена On-Demand — это цена самого дешёвого экземпляра текущего поколения типа C, M или R с указанными атрибутами. Если ни один экземпляр текущего поколения типа C, M или R не соответствует вашим атрибутам, то идентифицированная цена берётся из самых дешёвых экземпляров текущего поколения, а если и это не подходит, то из самых дешёвых экземпляров предыдущего поколения, которые соответствуют вашим атрибутам. При выборе Amazon EC2 типов экземпляров с вашими атрибутами он будет исключать типы экземпляров, цена которых превышает указанный порог.

Параметр принимает целое число, которое Amazon EC2 интерпретирует как процент.

Если вы установите TargetCapacityUnitType в vcpu или memory-mib , порог защиты цены будет основан на цене за vCPU или за память вместо цены за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если ни один из них не указан, Amazon EC2 автоматически применит оптимальную защиту цены для последовательного выбора из широкого диапазона типов экземпляров. Чтобы указать отсутствие порога защиты цены для Spot-инстансов, то есть вы хотите рассмотреть все типы экземпляров, которые соответствуют вашим атрибутам, включите один из этих параметров и укажите большое значение, например, 999999 .

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

Базовая производительность для рассмотрения, используя семейство экземпляров в качестве эталонной ссылки. Семейство экземпляров устанавливает минимально допустимый уровень производительности. Amazon EC2 использует этот базис для руководства выбором типа экземпляра, но нет гарантии, что выбранные типы экземпляров всегда будут превышать базовый уровень для каждого приложения. В настоящее время этот параметр поддерживает только производительность ЦП в качестве базового фактора производительности. Для получения дополнительной информации см. Защита производительности в руководстве пользователя Amazon EC2.

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

Производительность ЦП для рассмотрения, используя семейство экземпляров в качестве эталонной ссылки.

References -> (список)

Укажите семейство экземпляров, чтобы использовать его в качестве эталонной ссылки для производительности ЦП. Все типы экземпляров, которые соответствуют вашим указанным атрибутам, будут сравниваться с производительностью ЦП эталонного семейства экземпляров независимо от производителя ЦП или различий в архитектуре.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

(структура)

Укажите семейство экземпляров, чтобы использовать его в качестве эталонной ссылки для производительности ЦП. Все типы экземпляров, которые соответствуют вашим указанным атрибутам, будут сравниваться с производительностью ЦП эталонного семейства экземпляров независимо от производителя ЦП или архитектуры.

Примечание

В настоящее время в списке можно указать только одно семейство экземпляров.

InstanceFamily -> (строка)

Семейство экземпляров для использования в качестве эталонной ссылки.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё до точки (. ) в имени типа экземпляра. Например, в типе экземпляра c6i.large семейство экземпляров — c6i , а не c6 . Дополнительную информацию см. в руководстве Amazon EC2 Instance Types.

Следующие семейства экземпляров не поддерживаются для защиты производительности:

  • c1
  • g3 | g3s
  • hpc7g
  • m1 | m2
  • mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
  • p3dn | p4d | p5
  • t1
  • u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров в качестве значения для базовой производительности, API вернёт пустой ответ для GetInstanceTypesFromInstanceRequirements и исключение для CreateFleet , RequestSpotFleet , ModifyFleet и ModifySpotFleetRequest .

ImageId -> (строка)

ID AMI в формате ami-17characters00000 .

В качестве альтернативы вы можете указать параметр Systems Manager, используя один из следующих форматов. Параметр Systems Manager будет разрешён до AMI ID при запуске.

Для ссылки на публичный параметр:

  • ``resolve:ssm:public-parameter ``

Для ссылки на параметр, хранящийся в том же аккаунте:

  • ``resolve:ssm:parameter-name ``
  • ``resolve:ssm:parameter-name:version-number ``
  • ``resolve:ssm:parameter-name:label ``

Для ссылки на параметр, общий для другого аккаунта Amazon Web Services:

  • ``resolve:ssm:parameter-ARN ``
  • ``resolve:ssm:parameter-ARN:version-number ``
  • ``resolve:ssm:parameter-ARN:label ``

Дополнительную информацию см. в разделе Use a Systems Manager parameter instead of an AMI ID в руководстве пользователя Amazon EC2.

Примечание

Этот параметр доступен только для флотов типа instant . Для флотов типа maintain и request вы должны указать AMI ID в шаблоне запуска.

BlockDeviceMappings -> (список)

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

Поддерживается только для флотов типа instant.

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

(структура)

Описывает сопоставление блочных устройств, определяющее тома EBS и тома памяти экземпляра, которые должны быть подключены к экземпляру при запуске.

DeviceName -> (строка)

Имя устройства (например, /dev/sdh или xvdh).

VirtualName -> (строка)

Виртуальное имя устройства.

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

Параметры, используемые для автоматической настройки томов EBS при запуске экземпляра.

Encrypted -> (булево)

Указывает, зашифрован ли том.

DeleteOnTermination -> (булево)

Указывает, будет ли том удален при завершении работы экземпляра.

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

Количество операций ввода-вывода в секунду (IOPS). Для томов типов gp3, io1 и io2 это количество IOPS, предоставленных для тома. Для томов типа gp2 это базовая производительность тома и скорость накопления кредитов ввода-вывода для повышения производительности.

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

Пропускная способность, поддерживаемая томом, в MiB/с.

KmsKeyId -> (строка)

Идентификатор (ID ключа, псевдоним ключа, ARN ключа или ARN псевдонима) управляемого пользователем ключа KMS, который необходимо использовать для шифрования EBS.

SnapshotId -> (строка)

Идентификатор моментального снимка.

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

Размер тома в GiB.

VolumeType -> (строка)

Тип тома. Дополнительную информацию см. в разделе Типы томов Amazon EBS в руководстве пользователя Amazon EBS.

NoDevice -> (строка)

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

Lifecycle -> (строка)

Указывает, является ли запущенный экземпляр томом Spot Instance или On-Demand Instance.

InstanceIds -> (список)

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

(строка)

InstanceType -> (строка)

Тип экземпляра.

Platform -> (строка)

Значение равно windows для экземпляров Windows во флоте EC2. В противном случае значение пустое.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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