создать-шаблон-запуска
Описание
Создает шаблон запуска.
Шаблон запуска содержит параметры для запуска экземпляра. При запуске экземпляра с помощью RunInstances можно указать шаблон запуска вместо предоставления параметров запуска в запросе. Дополнительную информацию см. в разделе «Сохранение параметров запуска экземпляра в шаблонах запуска Amazon EC2» в руководстве пользователя Amazon EC2.
Для клонирования существующего шаблона запуска в качестве основы для нового шаблона запуска используйте консоль Amazon EC2. API, SDK и командная строка не поддерживают клонирование шаблона. Дополнительную информацию см. в разделе «Создание шаблона запуска из существующего шаблона запуска» в руководстве пользователя Amazon EC2.
См. также: Документация API AWS
Синтаксис
create-launch-template
[--dry-run | --no-dry-run]
[--client-token <value>]
--launch-template-name <value>
[--version-description <value>]
--launch-template-data <value>
[--operator <value>]
[--tag-specifications <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 (boolean)
DryRunOperation . В противном случае — UnauthorizedOperation .--client-token (string)
Уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Если токен клиента не указан, в запросе используется случайно сгенерированный токен для обеспечения идемпотентности.
Дополнительную информацию см. в разделе Обеспечение идемпотентности.
Ограничение: максимальная длина 128 ASCII символов.
--launch-template-name (string)
--version-description (string)
--launch-template-data (structure)
Информация для шаблона запуска.
KernelId -> (string)
Идентификатор ядра.
Предупреждение
Рекомендуется использовать PV-GRUB вместо ядер и RAM-дисков. Дополнительную информацию см. в разделе Пользовательские ядра в руководстве пользователя Amazon Linux 2.EbsOptimized -> (boolean)
IamInstanceProfile -> (structure)
Имя или Amazon Resource Name (ARN) профиля экземпляра IAM.
Arn -> (string)
Name -> (string)
BlockDeviceMappings -> (list)
Сопоставление блочных устройств.
(structure)
Описание сопоставления блочных устройств.
DeviceName -> (string)
VirtualName -> (string)
Ebs -> (structure)
Параметры для автоматической настройки томов EBS при запуске экземпляра.
Encrypted -> (boolean)
DeleteOnTermination -> (boolean)
Iops -> (integer)
Количество операций ввода-вывода в секунду (IOPS). Для томов gp3 , io1 и io2 это количество IOPS, выделенных для тома. Для томов gp2 это базовая производительность тома и скорость накопления кредитов ввода-вывода для увеличения производительности.
Ниже приведены поддерживаемые значения для каждого типа тома:
-
gp3: 3 000—16 000 IOPS -
io1: 100—64 000 IOPS -
io2: 100—256 000 IOPS
Для томов io2 вы можете достичь до 256 000 IOPS на экземплярах, построенных на платформе Nitro System. На других экземплярах вы можете достичь производительности до 32 000 IOPS.
Этот параметр поддерживается только для томов io1 , io2 и gp3 .
KmsKeyId -> (string)
SnapshotId -> (string)
VolumeSize -> (integer)
Размер тома в GiB. Вы должны указать либо идентификатор моментального снимка, либо размер тома. Ниже приведены поддерживаемые размеры томов для каждого типа тома:
-
gp2иgp3: 1—16 384 GiB -
io1: 4—16 384 GiB -
io2: 4—65 536 GiB -
st1иsc1: 125—16 384 GiB -
standard: 1—1024 GiB
VolumeType -> (string)
Throughput -> (integer)
Пропускная способность для выделения тома gp3 , максимальное значение — 1 000 MiB/с.
Допустимый диапазон: минимальное значение — 125. Максимальное значение — 1000.
VolumeInitializationRate -> (integer)
Указывает скорость инициализации тома Amazon EBS (скорость инициализации тома) в MiB/с, с которой должны загружаться блоки моментального снимка из Amazon S3 на том. Это также известно как «инициализация тома». Указание скорости инициализации тома гарантирует, что том будет инициализироваться с предсказуемой и согласованной скоростью после создания.
Этот параметр поддерживается только для томов, созданных из моментальных снимков. Пропустите этот параметр, если:
- Вы хотите создать том с помощью быстрого восстановления моментального снимка. Вы должны указать моментальный снимок, включенный для быстрого восстановления моментального снимка. В этом случае том будет полностью инициализирован при создании.
Примечание
Если вы укажете моментальный снимок, включенный для быстрого восстановления моментального снимка, и скорость инициализации тома, то том будет инициализирован со скоростью, указанной вами, а не с помощью быстрого восстановления моментального снимка.- Вы хотите создать том, который инициализируется со скоростью по умолчанию.
Дополнительную информацию см. в разделе Инициализация томов Amazon EBS в руководстве пользователя Amazon EC2.
Допустимый диапазон: 100—300 MiB/с
NoDevice -> (string)
NetworkInterfaces -> (list)
Сетевые интерфейсы для экземпляра.
(структура)
Параметры сетевого интерфейса.
AssociateCarrierIpAddress -> (boolean)
Связывает адрес Carrier IP с eth0 для нового сетевого интерфейса.
Используйте этот параметр при запуске экземпляра в Wavelength Zone для привязки адреса Carrier IP к сетевому интерфейсу. Дополнительную информацию об адресах Carrier IP см. в разделе "Адреса Carrier IP" в руководстве разработчика Wavelength.
AssociatePublicIpAddress -> (boolean)
Связывает общедоступный IPv4-адрес с eth0 для нового сетевого интерфейса.
Amazon Web Services взимает плату за все общедоступные IPv4-адреса, включая общедоступные IPv4-адреса, связанные с работающими экземплярами и Elastic IP-адресами. Дополнительную информацию см. на вкладке «Общедоступный IPv4-адрес» на странице цен Amazon VPC.
DeleteOnTermination -> (boolean)
Description -> (string)
DeviceIndex -> (integer)
interface, вы должны указать индекс устройства. Если вы создаёте шаблон запуска, содержащий вторичные сетевые интерфейсы, но не первичный интерфейс, то вы должны добавить первичный сетевой интерфейс в качестве параметра запуска при запуске экземпляра из шаблона.Groups -> (list)
Идентификаторы одного или нескольких сетевых групп.
(строка)
InterfaceType -> (string)
Тип сетевого интерфейса. Для создания Elastic Fabric Adapter (EFA) укажите efa или efa. Дополнительную информацию см. в разделе «Elastic Fabric Adapter для рабочих нагрузок AI/ML и HPC на Amazon EC2» в руководстве пользователя Amazon EC2.
Если вы не создаёте EFA, укажите interface или опустите этот параметр.
Если вы указываете efa-only, не назначайте IP-адреса сетевому интерфейсу. EFA-только сетевые интерфейсы не поддерживают IP-адреса.
Допустимые значения: interface | efa | efa-only
Ipv6AddressCount -> (integer)
Ipv6Addresses -> (list)
Один или несколько конкретных IPv6-адресов из диапазона IPv6 CIDR-блока вашей подсети. Вы не можете использовать этот параметр, если вы указываете количество IPv6-адресов.
(структура)
Описание IPv6-адреса.
Ipv6Address -> (string)
NetworkInterfaceId -> (string)
PrivateIpAddress -> (string)
PrivateIpAddresses -> (list)
Один или несколько частных IPv4-адресов.
(структура)
Описание вторичного частного IPv4-адреса для сетевого интерфейса.
Primary -> (boolean)
PrivateIpAddress -> (string)
SecondaryPrivateIpAddressCount -> (integer)
SubnetId -> (string)
NetworkCardIndex -> (integer)
Ipv4Prefixes -> (list)
Один или несколько IPv4-префиксов, которые необходимо назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv4PrefixCount.
(структура)
Описание параметра IPv4-префикса для сетевого интерфейса.
Ipv4Prefix -> (string)
Ipv4PrefixCount -> (integer)
Ipv4Prefix.Ipv6Prefixes -> (list)
Один или несколько IPv6-префиксов, которые необходимо назначить сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv6PrefixCount.
(структура)
Описание параметра IPv6-префикса для сетевого интерфейса.
Ipv6Prefix -> (string)
Ipv6PrefixCount -> (integer)
Ipv6Prefix.PrimaryIpv6 -> (boolean)
EnaSrdSpecification -> (структура)
Настройка параметров ENA Express для шаблона запуска.
EnaSrdEnabled -> (boolean)
EnaSrdUdpSpecification -> (структура)
Содержит настройки ENA Express для UDP-сетевого трафика для сетевого интерфейса, подключенного к экземпляру.
EnaSrdUdpEnabled -> (boolean)
true.ConnectionTrackingSpecification -> (структура)
Спецификация отслеживания соединений сетевой группы безопасности, которая позволяет установить таймаут для отслеживания соединений на сетевом интерфейсе Elastic. Дополнительную информацию см. в разделе «Таймаут отслеживания неактивных соединений» в руководстве пользователя Amazon EC2.
TcpEstablishedTimeout -> (integer)
UdpStreamTimeout -> (integer)
UdpTimeout -> (integer)
EnaQueueCount -> (integer)
ImageId -> (string)
Идентификатор AMI в формате ami-0ac394d6a3example.
В качестве альтернативы вы можете указать параметр 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.
Примечание
Если шаблон запуска будет использован для EC2 Fleet или Spot Fleet, обратите внимание на следующее:
- Только EC2 Fleets типа
instantподдерживают указание параметра Systems Manager. - Для EC2 Fleets типа
maintainилиrequest, или для Spot Fleets, необходимо указать идентификатор AMI.
InstanceType -> (string)
Тип экземпляра. Дополнительную информацию см. в разделе «Типы экземпляров Amazon EC2» в руководстве пользователя Amazon EC2.
Если вы укажете InstanceType, вы не можете указать InstanceRequirements.
KeyName -> (string)
Имя пары ключей. Вы можете создать пару ключей, используя CreateKeyPair или ImportKeyPair.
Предупреждение
Если вы не укажете пару ключей, вы не сможете подключиться к экземпляру, если не выберете AMI, настроенный для другой возможности входа.Monitoring -> (структура)
Мониторинг экземпляра.
Enabled -> (boolean)
true, чтобы включить подробный мониторинг. В противном случае включен базовый мониторинг.Placement -> (структура)
Размещение экземпляра.
AvailabilityZone -> (string)
Affinity -> (string)
GroupName -> (string)
HostId -> (string)
Tenancy -> (string)
SpreadDomain -> (string)
HostResourceGroupArn -> (string)
host.PartitionNumber -> (integer)
partition.GroupId -> (string)
RamDiskId -> (string)
Идентификатор диска RAM.
Предупреждение
Рекомендуется использовать PV-GRUB вместо ядра и дисков RAM. Для получения дополнительной информации см. Пользовательские ядра в Руководстве пользователя Amazon EC2.DisableApiTermination -> (boolean)
false, что означает, что вы можете завершить экземпляр с помощью консоли Amazon EC2, командных инструментов или API. Вы можете включить защиту от завершения при запуске экземпляра, в то время как экземпляр работает или приостановлен.InstanceInitiatedShutdownBehavior -> (string)
Указывает, останавливается или завершается экземпляр при инициации завершения с экземпляра (с помощью команды операционной системы для завершения работы системы).
По умолчанию: stop
UserData -> (string)
Данные пользователя, доступные экземпляру. Вы должны предоставить текст в кодировке base64. Данные пользователя ограничены 16 КБ. Для получения дополнительной информации см. Выполнение команд при запуске экземпляра EC2 с использованием входных данных пользователя в Руководстве пользователя Amazon EC2.
Если вы создаете шаблон запуска для использования с Batch, данные пользователя должны быть предоставлены в формате MIME многочастного архива. Для получения дополнительной информации см. Данные пользователя Amazon EC2 в шаблонах запуска в Руководстве пользователя Batch.
TagSpecifications -> (list)
Теги, применяемые к ресурсам, созданным во время запуска экземпляра. Эти теги не применяются к шаблону запуска.
(structure)
Спецификация тегов для ресурсов, созданных во время запуска экземпляра.
ResourceType -> (string)
Тип ресурса, которому нужно назначить теги.
Список допустимых значений содержит все типы ресурсов Amazon EC2, которым можно назначить теги. При создании шаблона запуска вы можете назначить теги только следующим типам ресурсов: instance | volume | network-interface | spot-instances-request. Если экземпляр не содержит указанный вами тип ресурса, запуск экземпляра завершится ошибкой. Например, не все типы экземпляров содержат том.
Для назначения тега ресурсу после его создания см. CreateTags.
Tags -> (list)
Теги, которые необходимо применить к ресурсу.
(structure)
Описание тега.
Key -> (string)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws:.
Value -> (string)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.
ElasticGpuSpecifications -> (list)
Устаревшее.
Примечание
Amazon Elastic Graphics достиг конца жизненного цикла 8 января 2024 года.(structure)
Примечание
Amazon Elastic Graphics достиг конца жизненного цикла 8 января 2024 года.Спецификация акселератора Elastic Graphics.
Type -> (string)
ElasticInferenceAccelerators -> (list)
Примечание
Amazon Elastic Inference больше недоступен.Акселератор Elastic Inference для привязки к экземпляру. Акселераторы Elastic Inference — это ресурс, который можно прикрепить к вашим экземплярам Amazon EC2 для ускорения ваших рабочих нагрузок по выводу глубокого обучения (DL).
Вы не можете указать акселераторы из разных поколений в одном запросе.
(structure)
Примечание
Amazon Elastic Inference больше недоступен.Описание акселератора Elastic Inference.
Type -> (string)
Count -> (integer)
Количество акселераторов Elastic Inference, которые необходимо подключить к экземпляру.
По умолчанию: 1
SecurityGroupIds -> (list)
Идентификаторы групп безопасности.
Если вы указываете сетевой интерфейс, вы должны указать все группы безопасности в составе сетевого интерфейса, а не использовать этот параметр.
(string)
SecurityGroups -> (list)
Названия групп безопасности. Для нестандартной VPC необходимо использовать идентификаторы групп безопасности.
Если вы указываете сетевой интерфейс, вы должны указать все группы безопасности в составе сетевого интерфейса, а не использовать этот параметр.
(string)
InstanceMarketOptions -> (structure)
Параметры рынка (покупки) для экземпляров.
MarketType -> (string)
SpotOptions -> (structure)
Параметры для Spot-экземпляров.
MaxPrice -> (string)
Максимальная почасовая цена, которую вы готовы платить за Spot-экземпляр. Не рекомендуется использовать этот параметр, так как он может привести к увеличению прерываний. Если вы не укажете этот параметр, вы будете платить текущую цену Spot. Если вы укажете этот параметр, он должен быть больше 0,001 USD. Указание значения ниже 0,001 USD приведет к сообщению об ошибке InvalidParameterValue при использовании шаблона запуска для запуска экземпляра.
Предупреждение
Если вы укажете максимальную цену, ваши Spot-экземпляры будут прерываться чаще, чем если вы не укажете этот параметр.SpotInstanceType -> (string)
BlockDurationMinutes -> (integer)
ValidUntil -> (timestamp)
Дата окончания запроса в формате UTC (YYYY-MM-DD T*HH:MM:SS* Z). Поддерживается только для постоянных запросов.
- Для постоянного запроса запрос остается активным до достижения указанной даты и времени. В противном случае запрос остается активным до его отмены.
- Для одноразового запроса
ValidUntilне поддерживается. Запрос остается активным до запуска всех экземпляров или до вашей отмены запроса.
По умолчанию: 7 дней с текущей даты
InstanceInterruptionBehavior -> (string)
terminate.CreditSpecification -> (structure)
Параметр кредита для использования процессора экземпляра. Действительно только для T-экземпляров.
CpuCredits -> (string)
Параметр кредита для использования процессора T-экземпляра.
Допустимые значения: standard | unlimited
CpuOptions -> (structure)
Параметры процессора для экземпляра. Для получения дополнительной информации см. Параметры процессора для экземпляров Amazon EC2 в Руководстве пользователя Amazon EC2.
CoreCount -> (integer)
ThreadsPerCore -> (integer)
1. В противном случае укажите значение по умолчанию 2.AmdSevSnp -> (string)
CapacityReservationSpecification -> (structure)
Параметр назначения резерва емкости. Если вы не укажете этот параметр, предпочтительный параметр резерва емкости экземпляра по умолчанию — open, что позволяет ему работать в любом свободном резерве емкости с соответствующими атрибутами (тип экземпляра, платформа, зона доступности).
CapacityReservationPreference -> (string)
Указывает предпочтения экземпляра в отношении резерва емкости. Возможные предпочтения включают:
-
capacity-reservations-only— экземпляр будет работать только в резерве емкости или группе резервов емкости. Если емкость недоступна, запуск экземпляра завершится ошибкой. -
open— экземпляр может работать в любомopenрезерве емкости, имеющем соответствующие атрибуты (тип экземпляра, платформа, зона доступности, аренда). -
none— экземпляр избегает работы в резерве емкости, даже если он доступен. Экземпляр работает в емкости On-Demand.
CapacityReservationTarget -> (structure)
Информация о целевом резерве емкости или группе резервов емкости.
CapacityReservationId -> (string)
CapacityReservationResourceGroupArn -> (string)
LicenseSpecifications -> (list)
Конфигурации лицензий.
(structure)
Описание конфигурации лицензии.
LicenseConfigurationArn -> (string)
HibernationOptions -> (structure)
Указывает, включен ли экземпляр для приостановки. Этот параметр действителен только в том случае, если экземпляр отвечает требованиям для приостановки. Для получения дополнительной информации см. Приостановка вашего экземпляра Amazon EC2 в Руководстве пользователя Amazon EC2.
Configured -> (boolean)
Если вы установите этот параметр в значение true, экземпляр будет включен для приостановки.
По умолчанию: false
MetadataOptions -> (structure)
Параметры метаданных для экземпляра. Дополнительную информацию см. в разделе Настройка параметров службы метаданных экземпляра в руководстве пользователя Amazon EC2.
HttpTokens -> (строка)
Указывает, требуется ли IMDSv2.
-
optional- IMDSv2 необязателен. Вы можете выбрать, отправлять ли маркер сеанса в запросах получения метаданных экземпляра. Если вы получаете учетные данные роли IAM без маркера сеанса, вы получаете учетные данные роли IMDSv1. Если вы получаете учетные данные роли IAM с использованием действительного маркера сеанса, вы получаете учетные данные роли IMDSv2. -
required- IMDSv2 обязателен. Вы должны отправлять маркер сеанса в запросах получения метаданных экземпляра. С этим параметром получение учетных данных роли IAM всегда возвращает учетные данные IMDSv2; учетные данные IMDSv1 недоступны.
По умолчанию: если значение ImdsSupport для образа Amazon Machine Image (AMI) вашего экземпляра равно v2.0, значение по умолчанию равно required.
HttpPutResponseHopLimit -> (целое число)
Желаемый предел переходов HTTP-ответа для запросов метаданных экземпляра. Чем больше число, тем дальше могут распространяться запросы метаданных экземпляра.
По умолчанию: 1
Возможные значения: целые числа от 1 до 64
HttpEndpoint -> (строка)
Включает или отключает HTTP-точку входа для метаданных на ваших экземплярах. Если параметр не указан, состояние по умолчанию равно enabled.
Примечание
Если вы укажете значениеdisabled, вы не сможете получить доступ к метаданным вашего экземпляра.HttpProtocolIpv6 -> (строка)
Включает или отключает IPv6-точку входа для службы метаданных экземпляра.
По умолчанию: disabled
InstanceMetadataTags -> (строка)
Установите значение enabled, чтобы разрешить доступ к меткам экземпляра из метаданных экземпляра. Установите значение disabled, чтобы отключить доступ к меткам экземпляра из метаданных экземпляра. Дополнительную информацию см. в разделе Просмотр меток для ваших экземпляров EC2 с помощью метаданных экземпляра.
По умолчанию: disabled
EnclaveOptions -> (структура)
Указывает, включён ли экземпляр для Amazon Web Services Nitro Enclaves. Дополнительную информацию см. в разделе Что такое Nitro Enclaves? в руководстве пользователя Amazon Web Services Nitro Enclaves.
Вы не можете включить Amazon Web Services Nitro Enclaves и режим гибернации на одном экземпляре.
Enabled -> (булево)
true.InstanceRequirements -> (структура)
Атрибуты для типов экземпляров. При указании атрибутов экземпляров Amazon EC2 определит типы экземпляров с этими атрибутами.
Вы должны указать VCpuCount и MemoryMiB. Все остальные атрибуты необязательны. Любой не указанный необязательный атрибут устанавливается по умолчанию.
При указании нескольких атрибутов вы получите типы экземпляров, удовлетворяющие всем указанным атрибутам. Если вы укажете несколько значений для атрибута, вы получите типы экземпляров, удовлетворяющие любому из указанных значений.
Чтобы ограничить список типов экземпляров, из которых Amazon EC2 может определить соответствующие типы экземпляров, вы можете использовать один из следующих параметров, но не оба в одном запросе:
-
AllowedInstanceTypes— типы экземпляров, которые следует включить в список. Все остальные типы экземпляров игнорируются, даже если они соответствуют вашим указанным атрибутам. -
ExcludedInstanceTypes— типы экземпляров, которые следует исключить из списка, даже если они соответствуют вашим указанным атрибутам.
Примечание
Если вы укажете InstanceRequirements, вы не можете указать InstanceType.
Выбор типа экземпляра на основе атрибутов поддерживается только при использовании групп Auto Scaling, EC2 Fleet и Spot Fleet для запуска экземпляров. Если вы планируете использовать шаблон запуска в мастер-приложении для запуска экземпляров или с API RunInstances или ресурсом AWS::EC2::Instance Amazon Web Services CloudFormation, вы не можете указать InstanceRequirements.
Дополнительную информацию см. в разделе Указание атрибутов для выбора типа экземпляра для EC2 Fleet или Spot Fleet и Оценка размещения Spot в Руководстве пользователя Amazon EC2.
VCpuCount -> (структура)
Минимальное и максимальное количество vCPU.
Min -> (целое число)
0.Max -> (целое число)
MemoryMiB -> (структура)
Минимальный и максимальный объем памяти в MiB.
Min -> (целое число)
0.Max -> (целое число)
CpuManufacturers -> (список)
Производители процессоров для включения.
- Для типов экземпляров с процессорами Intel укажите
intel. - Для типов экземпляров с процессорами AMD укажите
amd. - Для типов экземпляров с процессорами Amazon Web Services укажите
amazon-web-services. - Для типов экземпляров с процессорами Apple укажите
apple.
Примечание
Не следует путать производителя процессора с архитектурой процессора. Экземпляры будут запускаться с совместимой архитектурой процессора на основе образа Amazon Machine Image (AMI), который вы указываете в шаблоне запуска.По умолчанию: Любой производитель
(строка)
MemoryGiBPerVCpu -> (структура)
Минимальный и максимальный объем памяти на vCPU в GiB.
По умолчанию: Без минимальных или максимальных ограничений
Min -> (вещественное число)
Max -> (вещественное число)
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 -> (строка)
Указывает, должны ли типы экземпляров с виртуальной машиной включаться, исключаться или быть обязательными.
- Чтобы включить типы экземпляров с виртуальной машиной, укажите
included. - Чтобы потребовать только типы экземпляров с виртуальной машиной, укажите
required. - Чтобы исключить типы экземпляров с виртуальной машиной, укажите
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 -> (целое число)
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 -> (структура)
Минимальный и максимальный объём общей памяти ускорителей в MiB.
По умолчанию: нет минимальных или максимальных ограничений
Min -> (целое число)
Max -> (целое число)
NetworkBandwidthGbps -> (структура)
Минимальный и максимальный объём базовой пропускной способности сети в гигабитах в секунду (Gbps). Дополнительная информация приведена в разделе «Пропускная способность сети экземпляров 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 , порог защиты от цен будет основан на цене за процессорное ядро или за память вместо цены за экземпляр.
Примечание
Можно указать только один из параметров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.
PrivateDnsNameOptions -> (структура)
Параметры для имени хоста экземпляра. Значения по умолчанию наследуются из подсети.
HostnameType -> (строка)
EnableResourceNameDnsARecord -> (булево)
EnableResourceNameDnsAAAARecord -> (булево)
MaintenanceOptions -> (структура)
Параметры обслуживания экземпляра.
AutoRecovery -> (строка)
DisableApiStop -> (булево)
Operator -> (структура)
Сущность, которая управляет шаблоном запуска.
Principal -> (строка)
NetworkPerformanceOptions -> (структура)
Содержит настройки шаблона запуска для повышения производительности сети для типа рабочей нагрузки, выполняемой на вашем экземпляре.
BandwidthWeighting -> (строка)
Укажите параметр балансировки пропускной способности для повышения связанной базовой пропускной способности, как указано ниже:
Этот параметр использует стандартную конфигурацию пропускной способности для вашего типа экземпляра.
Этот параметр повышает вашу базовую пропускную способность сети и уменьшает вашу базовую пропускную способность EBS.
Этот параметр повышает вашу базовую пропускную способность EBS и уменьшает вашу базовую пропускную способность сети.
Синтаксис JSON:
{
"KernelId": "string",
"EbsOptimized": true|false,
"IamInstanceProfile": {
"Arn": "string",
"Name": "string"
},
"BlockDeviceMappings": [
{
"DeviceName": "string",
"VirtualName": "string",
"Ebs": {
"Encrypted": true|false,
"DeleteOnTermination": true|false,
"Iops": integer,
"KmsKeyId": "string",
"SnapshotId": "string",
"VolumeSize": integer,
"VolumeType": "standard"|"io1"|"io2"|"gp2"|"sc1"|"st1"|"gp3",
"Throughput": integer,
"VolumeInitializationRate": integer
},
"NoDevice": "string"
}
...
],
"NetworkInterfaces": [
{
"AssociateCarrierIpAddress": true|false,
"AssociatePublicIpAddress": true|false,
"DeleteOnTermination": true|false,
"Description": "string",
"DeviceIndex": integer,
"Groups": ["string", ...],
"InterfaceType": "string",
"Ipv6AddressCount": integer,
"Ipv6Addresses": [
{
"Ipv6Address": "string"
}
...
],
"NetworkInterfaceId": "string",
"PrivateIpAddress": "string",
"PrivateIpAddresses": [
{
"Primary": true|false,
"PrivateIpAddress": "string"
}
...
],
"SecondaryPrivateIpAddressCount": integer,
"SubnetId": "string",
"NetworkCardIndex": integer,
"Ipv4Prefixes": [
{
"Ipv4Prefix": "string"
}
...
],
"Ipv4PrefixCount": integer,
"Ipv6Prefixes": [
{
"Ipv6Prefix": "string"
}
...
],
"Ipv6PrefixCount": integer,
"PrimaryIpv6": true|false,
"EnaSrdSpecification": {
"EnaSrdEnabled": true|false,
"EnaSrdUdpSpecification": {
"EnaSrdUdpEnabled": true|false
}
},
"ConnectionTrackingSpecification": {
"TcpEstablishedTimeout": integer,
"UdpStreamTimeout": integer,
"UdpTimeout": integer
},
"EnaQueueCount": integer
}
...
],
"ImageId": "string",
"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",
"KeyName": "string",
"Monitoring": {
"Enabled": true|false
},
"Placement": {
"AvailabilityZone": "string",
"Affinity": "string",
"GroupName": "string",
"HostId": "string",
"Tenancy": "default"|"dedicated"|"host",
"SpreadDomain": "string",
"HostResourceGroupArn": "string",
"PartitionNumber": integer,
"GroupId": "string"
},
"RamDiskId": "string",
"DisableApiTermination": true|false,
"InstanceInitiatedShutdownBehavior": "stop"|"terminate",
"UserData": "string",
"TagSpecifications": [
{
"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"
}
...
]
}
...
],
"ElasticGpuSpecifications": [
{
"Type": "string"
}
...
],
"ElasticInferenceAccelerators": [
{
"Type": "string",
"Count": integer
}
...
],
"SecurityGroupIds": ["string", ...],
"SecurityGroups": ["string", ...],
"InstanceMarketOptions": {
"MarketType": "spot"|"capacity-block",
"SpotOptions": {
"MaxPrice": "string",
"SpotInstanceType": "one-time"|"persistent",
"BlockDurationMinutes": integer,
"ValidUntil": timestamp,
"InstanceInterruptionBehavior": "hibernate"|"stop"|"terminate"
}
},
"CreditSpecification": {
"CpuCredits": "string"
},
"CpuOptions": {
"CoreCount": integer,
"ThreadsPerCore": integer,
"AmdSevSnp": "enabled"|"disabled"
},
"CapacityReservationSpecification": {
"CapacityReservationPreference": "capacity-reservations-only"|"open"|"none",
"CapacityReservationTarget": {
"CapacityReservationId": "string",
"CapacityReservationResourceGroupArn": "string"
}
},
"LicenseSpecifications": [
{
"LicenseConfigurationArn": "string"
}
...
],
"HibernationOptions": {
"Configured": true|false
},
"MetadataOptions": {
"HttpTokens": "optional"|"required",
"HttpPutResponseHopLimit": integer,
"HttpEndpoint": "disabled"|"enabled",
"HttpProtocolIpv6": "disabled"|"enabled",
"InstanceMetadataTags": "disabled"|"enabled"
},
"EnclaveOptions": {
"Enabled": true|false
},
"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"
}
...
]
}
}
},
"PrivateDnsNameOptions": {
"HostnameType": "ip-name"|"resource-name",
"EnableResourceNameDnsARecord": true|false,
"EnableResourceNameDnsAAAARecord": true|false
},
"MaintenanceOptions": {
"AutoRecovery": "default"|"disabled"
},
"DisableApiStop": true|false,
"Operator": {
"Principal": "string"
},
"NetworkPerformanceOptions": {
"BandwidthWeighting": "default"|"vpc-1"|"ebs-1"
}
}
--operator (структура)
Зарезервировано для внутреннего использования.
Principal -> (строка)
Сокращенный синтаксис:
Principal=string
Синтаксис JSON:
{
"Principal": "string"
}
--tag-specifications (список)
Теги, которые необходимо применить к шаблону запуска при создании. Чтобы добавить теги к шаблону запуска, тип ресурса должен быть launch-template .
Чтобы указать теги для ресурсов, которые создаются при запуске экземпляра, необходимо использовать параметр TagSpecifications в структуре данных шаблона запуска.
(структура)
Теги, которые необходимо применить к ресурсу при его создании. При указании тега необходимо указать тип ресурса, к которому применяются теги, в противном случае запрос завершится ошибкой.
Примечание
СписокValid Values содержит все типы ресурсов, которые могут быть помечены. Однако используемое действие может не поддерживать маркирование всех этих типов ресурсов. Если вы попытаетесь добавить тег к типу ресурса, который не поддерживается используемым действием, вы получите ошибку.ResourceType -> (строка)
Tags -> (список)
Теги, которые необходимо применить к ресурсу.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают не более 127 символов Юникода. Не может начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают не более 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"
}
...
]
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если не указано значение или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команды и вернет пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладочную запись журналов.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 предполагает, что двоичные блоки предоставляются в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить вывод страницы CLI.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры командной строки CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве «Начало работы» в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Пример 1: Создание шаблона запуска
Следующий create-launch-template пример создаёт шаблон запуска, который указывает подсеть для запуска экземпляра, назначает экземпляру общедоступный IP-адрес и адрес IPv6, и создаёт тег для экземпляра.
aws ec2 create-launch-template \
--launch-template-name TemplateForWebServer \
--version-description WebVersion1 \
--launch-template-data '{"NetworkInterfaces":[{"AssociatePublicIpAddress":true,"DeviceIndex":0,"Ipv6AddressCount":1,"SubnetId":"subnet-7b16de0c"}],"ImageId":"ami-8c1be5f6","InstanceType":"t2.small","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"purpose","Value":"webserver"}]}]}'
Вывод:
{
"LaunchTemplate": {
"LatestVersionNumber": 1,
"LaunchTemplateId": "lt-01238c059e3466abc",
"LaunchTemplateName": "TemplateForWebServer",
"DefaultVersionNumber": 1,
"CreatedBy": "arn:aws:iam::123456789012:user/Bob",
"CreateTime": "2019-01-27T09:13:24.000Z"
}
}
Дополнительную информацию см. в разделе Запуск экземпляра из шаблона запуска в Руководстве пользователя Amazon Elastic Compute Cloud. Сведения о цитировании параметров в формате JSON см. в разделе Цитирование строк в Руководстве пользователя командной строки AWS.
Пример 2: Создание шаблона запуска для Amazon EC2 Auto Scaling
Следующий create-launch-template пример создаёт шаблон запуска с несколькими тегами и отображением блочного устройства, чтобы указать дополнительный том EBS при запуске экземпляра. Укажите значение для Groups, соответствующее группам безопасности для VPC, в которые ваша группа Auto Scaling будет запускать экземпляры. Укажите VPC и подсети как свойства группы Auto Scaling.
aws ec2 create-launch-template \
--launch-template-name TemplateForAutoScaling \
--version-description AutoScalingVersion1 \
--launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"AssociatePublicIpAddress":true,"Groups":["sg-7c227019,sg-903004f8"],"DeleteOnTermination":true}],"ImageId":"ami-b42209de","InstanceType":"m4.large","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"environment","Value":"production"},{"Key":"purpose","Value":"webserver"}]},{"ResourceType":"volume","Tags":[{"Key":"environment","Value":"production"},{"Key":"cost-center","Value":"cc123"}]}],"BlockDeviceMappings":[{"DeviceName":"/dev/sda1","Ebs":{"VolumeSize":100}}]}' --region us-east-1
Вывод:
{
"LaunchTemplate": {
"LatestVersionNumber": 1,
"LaunchTemplateId": "lt-0123c79c33a54e0abc",
"LaunchTemplateName": "TemplateForAutoScaling",
"DefaultVersionNumber": 1,
"CreatedBy": "arn:aws:iam::123456789012:user/Bob",
"CreateTime": "2019-04-30T18:16:06.000Z"
}
}
Дополнительную информацию см. в разделе Создание шаблона запуска для группы Auto Scaling в Руководстве пользователя Amazon EC2 Auto Scaling. Сведения о цитировании параметров в формате JSON см. в разделе Цитирование строк в Руководстве пользователя командной строки AWS.
Пример 3: Создание шаблона запуска, задающего шифрование томов EBS
Следующий create-launch-template пример создает шаблон запуска, включающий зашифрованные тома EBS, созданные из незашифрованной копии. Он также добавляет теги к томам во время создания. Если шифрование по умолчанию отключено, необходимо указать параметр "Encrypted", как показано в следующем примере. Если вы используете параметр "KmsKeyId" для указания управляемого клиентом CMK, вы также должны указать параметр "Encrypted", даже если шифрование по умолчанию включено.
aws ec2 create-launch-template \
--launch-template-name TemplateForEncryption \
--launch-template-data file://config.json
Содержание config.json:
{
"BlockDeviceMappings":[
{
"DeviceName":"/dev/sda1",
"Ebs":{
"VolumeType":"gp2",
"DeleteOnTermination":true,
"SnapshotId":"snap-066877671789bd71b",
"Encrypted":true,
"KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef"
}
}
],
"ImageId":"ami-00068cd7555f543d5",
"InstanceType":"c5.large",
"TagSpecifications":[
{
"ResourceType":"volume",
"Tags":[
{
"Key":"encrypted",
"Value":"yes"
}
]
}
]
}
Вывод:
{
"LaunchTemplate": {
"LatestVersionNumber": 1,
"LaunchTemplateId": "lt-0d5bd51bcf8530abc",
"LaunchTemplateName": "TemplateForEncryption",
"DefaultVersionNumber": 1,
"CreatedBy": "arn:aws:iam::123456789012:user/Bob",
"CreateTime": "2020-01-07T19:08:36.000Z"
}
}
Дополнительную информацию см. в разделах Восстановление тома Amazon EBS из копии и Шифрование по умолчанию в Руководстве пользователя Amazon Elastic Compute Cloud.
Вывод
LaunchTemplate -> (структура)
Информация о шаблоне запуска.
LaunchTemplateId -> (строка)
LaunchTemplateName -> (строка)
CreateTime -> (метка времени)
CreatedBy -> (строка)
DefaultVersionNumber -> (целое число)
LatestVersionNumber -> (целое число)
Tags -> (список)
Теги для шаблона запуска.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов чувствительны к регистру и принимают не более 127 символов Юникода. Не может начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: Значения тегов чувствительны к регистру и принимают не более 256 символов Юникода.
Operator -> (структура)
Сущность, управляющая шаблоном запуска.
Managed -> (булево)
true , ресурс управляется поставщиком услуг.Principal -> (строка)
managed равен true , то возвращается субъект. Субъект — это поставщик услуг, управляющий ресурсом.Warning -> (структура)
Если шаблон запуска содержит параметры или комбинации параметров, которые некорректны, для каждой проблемы возвращаются код ошибки и сообщение об ошибке.
Errors -> (список)
Коды ошибок и сообщения об ошибках.
(структура)
Код ошибки и сообщение об ошибке, возвращаемые для параметра или комбинации параметров, которые некорректны при создании нового шаблона запуска или новой версии шаблона запуска.
Code -> (строка)
Message -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.