describe-launch-template-versions
Описание
Описывает одну или несколько версий указанной шаблона запуска. Вы можете описать все версии, отдельные версии или диапазон версий. Вы также можете описать все последние версии или все версии по умолчанию всех шаблонов запуска в вашей учетной записи.
См. также: Документация API AWS
describe-launch-template-versions является постраничной операцией. Для получения всего набора результатов могут быть вызваны несколько вызовов API. Вы можете отключить постраничную загрузку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответ с постраничной загрузкой аргумент --query должен извлекать данные из результатов следующих выражений запроса: LaunchTemplateVersions
Синтаксис
describe-launch-template-versions
[--dry-run | --no-dry-run]
[--launch-template-id <value>]
[--launch-template-name <value>]
[--versions <value>]
[--min-version <value>]
[--max-version <value>]
[--filters <value>]
[--resolve-alias | --no-resolve-alias]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--dry-run | --no-dry-run (boolean)
DryRunOperation . В противном случае это UnauthorizedOperation .--launch-template-id (string)
Идентификатор шаблона запуска.
Для описания одной или нескольких версий указанного шаблона запуска необходимо указать либо идентификатор шаблона запуска, либо имя шаблона запуска, но не оба.
Для описания всех последних или по умолчанию версий шаблонов запуска в вашей учетной записи необходимо опустить этот параметр.
--launch-template-name (string)
Имя шаблона запуска.
Для описания одной или нескольких версий указанного шаблона запуска необходимо указать либо имя шаблона запуска, либо идентификатор шаблона запуска, но не оба.
Для описания всех последних или по умолчанию версий шаблонов запуска в вашей учетной записи необходимо опустить этот параметр.
--versions (list)
Одна или несколько версий шаблона запуска. Допустимые значения зависят от того, описываете ли вы указанный шаблон запуска (по идентификатору или имени) или все шаблоны запуска в вашей учетной записи.
Для описания одной или нескольких версий указанного шаблона запуска допустимые значения являются $Latest , $Default и числами.
Для описания всех шаблонов запуска в вашей учетной записи, определенных как последняя версия, допустимое значение - $Latest . Для описания всех шаблонов запуска в вашей учетной записи, определенных как версия по умолчанию, допустимое значение - $Default . Вы можете указать $Latest и $Default в одном запросе. Вы не можете указать числа.
(string)
Синтаксис:
"string" "string" ...
--min-version (string)
--max-version (string)
--filters (list)
Один или несколько фильтров.
-
create-time- Время создания версии шаблона запуска. -
ebs-optimized- Булево значение, указывающее, оптимизирован ли экземпляр для ввода-вывода Amazon EBS. -
http-endpoint- Указывает, включен ли HTTP-метаданных-точке доступа к вашим экземплярам (enabled|disabled). -
http-protocol-ipv4- Указывает, включена ли IPv4-точка доступа к службе метаданных экземпляра (enabled|disabled). -
host-resource-group-arn- ARN группы ресурсов хоста, в которой запускаются экземпляры. -
http-tokens- Состояние использования токена для ваших запросов метаданных экземпляра (optional|required). -
iam-instance-profile- ARN профиля IAM экземпляра. -
image-id- Идентификатор AMI. -
instance-type- Тип экземпляра. -
is-default-version- Булево значение, указывающее, является ли версия шаблона запуска версией по умолчанию. -
kernel-id- Идентификатор ядра. -
license-configuration-arn- ARN конфигурации лицензии. -
network-card-index- Индекс сетевой карты. -
ram-disk-id- Идентификатор диска RAM.
(structure)
Пара имя-значение фильтра, используемый для возврата более конкретного списка результатов из операции описания. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с AND , и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.
Для получения дополнительной информации см. Список и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2 .
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с OR , и запрос возвращает все результаты, которые соответствуют любому из указанных значений.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--resolve-alias | --no-resolve-alias (boolean)
Если true и если для ImageId указан параметр Systems Manager, идентификатор AMI отображается в ответе для imageId .
Если false и если для ImageId указан параметр Systems Manager, параметр отображается в ответе для imageId .
Дополнительную информацию см. в разделе "Использование параметра Systems Manager вместо идентификатора AMI" в Руководстве пользователя Amazon EC2 .
По умолчанию: false
--cli-input-json | --cli-input-yaml (string) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределят значения, предоставленные в формате JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного в JSON значения, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (string)
Токен для указания места начала постраничной загрузки. Это NextToken из ранее обрываемого ответа.
Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface .
--page-size (integer)
Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, получая меньшее количество элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-службы.
Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface .
--max-items (integer)
Общее количество элементов, которые необходимо вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken . Для возобновления постраничной загрузки предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная загрузка в Руководстве пользователя AWS Command Line Interface .
--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)
Включить/выключить цветной вывод.
- включить
- выключить
- автоматически
--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.
Для описания версий шаблонов запуска
Этот пример описывает версии указанного шаблона запуска.
Команда:
aws ec2 describe-launch-template-versions --launch-template-id lt-068f72b72934aff71
Вывод:
{
"LaunchTemplateVersions": [
{
"LaunchTemplateId": "lt-068f72b72934aff71",
"LaunchTemplateName": "Webservers",
"VersionNumber": 3,
"CreatedBy": "arn:aws:iam::123456789102:root",
"LaunchTemplateData": {
"KeyName": "kp-us-east",
"ImageId": "ami-6057e21a",
"InstanceType": "t2.small",
"NetworkInterfaces": [
{
"SubnetId": "subnet-7b16de0c",
"DeviceIndex": 0,
"Groups": [
"sg-7c227019"
]
}
]
},
"DefaultVersion": false,
"CreateTime": "2017-11-20T13:19:54.000Z"
},
{
"LaunchTemplateId": "lt-068f72b72934aff71",
"LaunchTemplateName": "Webservers",
"VersionNumber": 2,
"CreatedBy": "arn:aws:iam::123456789102:root",
"LaunchTemplateData": {
"KeyName": "kp-us-east",
"ImageId": "ami-6057e21a",
"InstanceType": "t2.medium",
"NetworkInterfaces": [
{
"SubnetId": "subnet-1a2b3c4d",
"DeviceIndex": 0,
"Groups": [
"sg-7c227019"
]
}
]
},
"DefaultVersion": false,
"CreateTime": "2017-11-20T13:12:32.000Z"
},
{
"LaunchTemplateId": "lt-068f72b72934aff71",
"LaunchTemplateName": "Webservers",
"VersionNumber": 1,
"CreatedBy": "arn:aws:iam::123456789102:root",
"LaunchTemplateData": {
"UserData": "",
"KeyName": "kp-us-east",
"ImageId": "ami-aabbcc11",
"InstanceType": "t2.medium",
"NetworkInterfaces": [
{
"SubnetId": "subnet-7b16de0c",
"DeviceIndex": 0,
"DeleteOnTermination": false,
"Groups": [
"sg-7c227019"
],
"AssociatePublicIpAddress": true
}
]
},
"DefaultVersion": true,
"CreateTime": "2017-11-20T12:52:33.000Z"
}
]
}
Вывод
LaunchTemplateVersions -> (список)
Информация о версиях шаблонов запуска.
(структура)
Описание версии шаблона запуска.
LaunchTemplateId -> (строка)
LaunchTemplateName -> (строка)
VersionNumber -> (целое число)
VersionDescription -> (строка)
CreateTime -> (метка времени)
CreatedBy -> (строка)
DefaultVersion -> (boolean)
LaunchTemplateData -> (структура)
Информация о шаблоне запуска.
KernelId -> (строка)
EbsOptimized -> (логическое значение)
IamInstanceProfile -> (структура)
Профиль IAM виртуальной машины.
Arn -> (строка)
Name -> (строка)
BlockDeviceMappings -> (список)
Сопоставления блочных устройств.
(структура)
Описание сопоставления блочных устройств.
DeviceName -> (строка)
VirtualName -> (строка)
Ebs -> (структура)
Информация о блочном устройстве для тома EBS.
Encrypted -> (логическое значение)
DeleteOnTermination -> (логическое значение)
Iops -> (целое число)
KmsKeyId -> (строка)
SnapshotId -> (строка)
VolumeSize -> (целое число)
VolumeType -> (строка)
Throughput -> (целое число)
VolumeInitializationRate -> (целое число)
null.NoDevice -> (строка)
NetworkInterfaces -> (список)
Сетевые интерфейсы.
(структура)
Описание сетевого интерфейса.
AssociateCarrierIpAddress -> (логическое значение)
Указывает, следует ли назначить адрес Carrier IP с eth0 для нового сетевого интерфейса.
Используйте этот параметр при запуске виртуальной машины в зоне Wavelength и хотите назначить адрес Carrier IP сетевому интерфейсу. Дополнительную информацию об адресах Carrier IP см. в разделе "Carrier IP address" в руководстве разработчика Wavelength.
AssociatePublicIpAddress -> (логическое значение)
Указывает, следует ли назначить публичный IPv4-адрес с eth0 для нового сетевого интерфейса.
Amazon Web Services взимает плату за все публичные IPv4-адреса, включая публичные IPv4-адреса, связанные с работающими виртуальными машинами и Elastic IP-адресами. Дополнительную информацию см. на странице цен Amazon VPC в разделе "Public IPv4 Address".
DeleteOnTermination -> (логическое значение)
Description -> (строка)
DeviceIndex -> (целое число)
Groups -> (список)
Идентификаторы одного или нескольких групп безопасности.
(строка)
InterfaceType -> (строка)
Ipv6AddressCount -> (целое число)
Ipv6Addresses -> (список)
IPv6-адреса для сетевого интерфейса.
(структура)
Описание IPv6-адреса.
Ipv6Address -> (строка)
IsPrimaryIpv6 -> (логическое значение)
NetworkInterfaceId -> (строка)
PrivateIpAddress -> (строка)
PrivateIpAddresses -> (список)
Один или несколько частных IPv4-адресов.
(структура)
Описание дополнительного частного IPv4-адреса для сетевого интерфейса.
Primary -> (логическое значение)
PrivateIpAddress -> (строка)
SecondaryPrivateIpAddressCount -> (целое число)
SubnetId -> (строка)
NetworkCardIndex -> (целое число)
Ipv4Prefixes -> (список)
Один или несколько IPv4-префиксов, назначенных сетевому интерфейсу.
(структура)
Информация об IPv4-делегированных префиксах, назначенных сетевому интерфейсу.
Ipv4Prefix -> (строка)
Ipv4PrefixCount -> (целое число)
Ipv6Prefixes -> (список)
Один или несколько IPv6-префиксов, назначенных сетевому интерфейсу.
(структура)
Информация об IPv6-делегированных префиксах, назначенных сетевому интерфейсу.
Ipv6Prefix -> (строка)
Ipv6PrefixCount -> (целое число)
PrimaryIpv6 -> (логическое значение)
EnaSrdSpecification -> (структура)
Содержит параметры ENA Express для виртуальных машин, запущенных из шаблона запуска.
EnaSrdEnabled -> (логическое значение)
EnaSrdUdpSpecification -> (структура)
Настраивает ENA Express для сетевого трафика UDP.
EnaSrdUdpEnabled -> (логическое значение)
ConnectionTrackingSpecification -> (структура)
Спецификация отслеживания соединений группы безопасности, которая позволяет задать таймаут для отслеживания соединений на сетевом интерфейсе Elastic. Дополнительную информацию см. в разделе "Idle connection tracking timeout" в руководстве пользователя Amazon EC2.
TcpEstablishedTimeout -> (целое число)
UdpTimeout -> (целое число)
UdpStreamTimeout -> (целое число)
EnaQueueCount -> (целое число)
ImageId -> (строка)
Идентификатор AMI или параметра Systems Manager. Параметр Systems Manager будет преобразован в ID AMI при запуске виртуальной машины.
Значение зависит от того, что вы указали в запросе. Возможные значения:
- Если в запросе был указан ID AMI, то это ID AMI.
- Если в запросе был указан параметр Systems Manager, и
ResolveAliasбыл настроен какtrue, то это ID AMI, которому параметр сопоставлен в Parameter Store. - Если в запросе был указан параметр Systems Manager, и
ResolveAliasбыл настроен какfalse, то это значение параметра.
Дополнительную информацию см. в разделе "Use a Systems Manager parameter instead of an AMI ID" в руководстве пользователя Amazon EC2.
InstanceType -> (строка)
KeyName -> (строка)
Monitoring -> (структура)
Мониторинг виртуальной машины.
Enabled -> (логическое значение)
Placement -> (структура)
Расположение виртуальной машины.
AvailabilityZone -> (строка)
Affinity -> (строка)
GroupName -> (строка)
HostId -> (строка)
Tenancy -> (строка)
dedicated работает на оборудовании с однопользовательским доступом.SpreadDomain -> (строка)
HostResourceGroupArn -> (строка)
PartitionNumber -> (целое число)
partition.GroupId -> (строка)
RamDiskId -> (строка)
DisableApiTermination -> (логическое значение)
true, указывает, что виртуальную машину нельзя завершить с помощью консоли Amazon EC2, инструмента командной строки или API.InstanceInitiatedShutdownBehavior -> (строка)
UserData -> (строка)
TagSpecifications -> (список)
Теги, применяемые к ресурсам, созданным во время запуска экземпляра.
(структура)
Спецификация тегов для шаблона запуска.
ResourceType -> (строка)
Tags -> (список)
Теги для ресурса.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают не более 127 символов Юникода. Не могут начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают не более 256 символов Юникода.
ElasticGpuSpecifications -> (список)
Устаревшее поле.
Примечание
Amazon Elastic Graphics прекратил работу 8 января 2024 года.(структура)
Устаревшее поле.
Примечание
Amazon Elastic Graphics прекратил работу 8 января 2024 года.Type -> (строка)
Устаревшее поле.
Примечание
Amazon Elastic Graphics прекратил работу 8 января 2024 года.ElasticInferenceAccelerators -> (список)
Примечание
Amazon Elastic Inference больше недоступен.Ускоритель Elastic Inference для ассоциации с экземпляром. Ускорители Elastic Inference — это ресурс, который можно подключить к вашим экземплярам Amazon EC2 для ускорения рабочих нагрузок вывода глубокого обучения (Deep Learning).
Вы не можете указать ускорители из разных поколений в одном запросе.
(структура)
Примечание
Amazon Elastic Inference больше недоступен.Описание ускорителя Elastic Inference.
Type -> (строка)
Count -> (целое число)
Количество ускорителей Elastic Inference, подключаемых к экземпляру.
Значение по умолчанию: 1
SecurityGroupIds -> (список)
Идентификаторы групп безопасности.
(строка)
SecurityGroups -> (список)
Имена групп безопасности.
(строка)
InstanceMarketOptions -> (структура)
Рыночный вариант (покупки) для экземпляров.
MarketType -> (строка)
SpotOptions -> (структура)
Параметры для Spot-экземпляров.
MaxPrice -> (строка)
InvalidParameterValue при использовании шаблона запуска для запуска экземпляра.SpotInstanceType -> (строка)
BlockDurationMinutes -> (целое число)
ValidUntil -> (метка времени)
InstanceInterruptionBehavior -> (строка)
CreditSpecification -> (структура)
Вариант кредитования для использования ЦП экземпляра.
CpuCredits -> (строка)
Вариант кредитования для использования ЦП экземпляра типа T.
Допустимые значения: standard | unlimited
CpuOptions -> (структура)
Параметры ЦП для экземпляра. Дополнительную информацию см. в разделе Параметры ЦП для экземпляров Amazon EC2 в руководстве пользователя Amazon EC2.
CoreCount -> (целое число)
ThreadsPerCore -> (целое число)
AmdSevSnp -> (строка)
CapacityReservationSpecification -> (структура)
Информация о варианте назначения резерва емкости.
CapacityReservationPreference -> (строка)
Указывает предпочтения экземпляра по резервам емкости. Возможные предпочтения:
-
open— экземпляр может работать в любом резерве емкостиopen, имеющем соответствующие атрибуты (тип экземпляра, платформа, зона доступности). -
none— экземпляр избегает работы в резерве емкости, даже если он доступен. Экземпляр работает на ресурсах по требованию.
CapacityReservationTarget -> (структура)
Информация о целевом резерве емкости или группе резервов емкости.
CapacityReservationId -> (строка)
CapacityReservationResourceGroupArn -> (строка)
LicenseSpecifications -> (список)
Конфигурации лицензий.
(структура)
Описание конфигурации лицензии.
LicenseConfigurationArn -> (строка)
HibernationOptions -> (структура)
Указывает, настроен ли экземпляр для гибернации. Дополнительную информацию см. в разделе Гибернация экземпляра Amazon EC2 в руководстве пользователя Amazon EC2.
Configured -> (булево значение)
true, экземпляр включен для гибернации; в противном случае — нет.MetadataOptions -> (структура)
Параметры метаданных для экземпляра. Дополнительную информацию см. в разделе Настройка параметров службы метаданных экземпляра в руководстве пользователя Amazon EC2.
State -> (строка)
Состояние изменения параметров метаданных.
pending — параметры метаданных обновляются, и экземпляр не готов обрабатывать трафик метаданных с новым выбором.
applied — параметры метаданных успешно применены к экземпляру.
HttpTokens -> (строка)
Указывает, требуется ли IMDSv2.
-
optional— IMDSv2 необязателен. Вы можете выбрать, отправлять ли маркер сеанса в запросах извлечения метаданных экземпляра. Если вы извлекаете учетные данные роли IAM без маркера сеанса, вы получаете учетные данные роли IMDSv1. Если вы извлекаете учетные данные роли IAM с помощью действительного маркера сеанса, вы получаете учетные данные роли IMDSv2. -
required— IMDSv2 требуется. Вы должны отправлять маркер сеанса в запросах извлечения метаданных экземпляра. С этим вариантом извлечение учетных данных роли IAM всегда возвращает учетные данные IMDSv2; учетные данные IMDSv1 недоступны.
HttpPutResponseHopLimit -> (целое число)
Желаемый предел переходов HTTP PUT-ответа для запросов метаданных экземпляра. Чем больше число, тем дальше запросы метаданных экземпляра могут распространяться.
Значение по умолчанию: 1
Возможные значения: целые числа от 1 до 64
HttpEndpoint -> (строка)
Включает или отключает HTTP-точку входа метаданных для ваших экземпляров. Если параметр не указан, состояние по умолчанию — enabled.
Примечание
Если вы укажете значениеdisabled, вы не сможете получить доступ к метаданным экземпляра.HttpProtocolIpv6 -> (строка)
Включает или отключает IPv6-точку входа для службы метаданных экземпляра.
Значение по умолчанию: disabled
InstanceMetadataTags -> (строка)
Установите в enabled, чтобы разрешить доступ к тегам экземпляра из метаданных экземпляра. Установите в disabled, чтобы отключить доступ к тегам экземпляра из метаданных экземпляра. Дополнительную информацию см. в разделе Просмотр тегов для ваших экземпляров EC2 с помощью метаданных экземпляра.
Значение по умолчанию: disabled
EnclaveOptions -> (структура)
Указывает, включен ли экземпляр для Amazon Web Services Nitro Enclaves.
Enabled -> (булево значение)
true, экземпляр включен для Amazon Web Services Nitro Enclaves; в противном случае — нет.InstanceRequirements -> (структура)
Атрибуты для типов экземпляров. При указании атрибутов экземпляров Amazon EC2 определит типы экземпляров с этими атрибутами.
Если вы укажете InstanceRequirements, вы не можете указать InstanceTypes.
VCpuCount -> (структура)
Минимальное и максимальное количество vCPU.
Min -> (целое число)
0, минимальное ограничение отсутствует.Max -> (целое число)
MemoryMiB -> (структура)
Минимальный и максимальный объем памяти в MiB.
Min -> (целое число)
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 -> (строка)
Указывает, должны ли включаться, исключаться или требоваться типы экземпляров bare metal.
- Для включения типов экземпляров bare metal укажите
included. - Для требования только типов экземпляров bare metal укажите
required. - Для исключения типов экземпляров bare metal укажите
excluded.
Значение по умолчанию: excluded
BurstablePerformance -> (строка)
Указывает, включаются ли типы экземпляров T с производительностью Burstable, исключаются или требуются. Дополнительные сведения см. в разделе Экземпляры с производительностью Burstable.
- Для включения типов экземпляров с производительностью Burstable укажите
included. - Для требования только типов экземпляров с производительностью Burstable укажите
required. - Для исключения типов экземпляров с производительностью Burstable укажите
excluded.
Значение по умолчанию: excluded
RequireHibernateSupport -> (булево)
Указывает, должны ли типы экземпляров поддерживать гибернацию для экземпляров On-Demand.
Этот параметр не поддерживается для GetSpotPlacementScores.
Значение по умолчанию: false
NetworkInterfaceCount -> (структура)
Минимальное и максимальное количество сетевых интерфейсов.
Значение по умолчанию: Минимальные и максимальные ограничения отсутствуют
Min -> (целое число)
Max -> (целое число)
LocalStorage -> (строка)
Указывает, включаются ли, исключаются или требуются типы экземпляров с томами хранилища экземпляра. Дополнительные сведения см. в разделе Amazon EC2 instance store в Руководстве пользователя 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. - Для типов экземпляров с чипами 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 -> (структура)
Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Гбит/с).
По умолчанию: Нет минимальных или максимальных ограничений
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 -> (структура)
Сущность, которая управляет шаблоном запуска.
Managed -> (булево)
true, ресурс управляется поставщиком услуг.Principal -> (строка)
managed равно true, то возвращается principal. Principal - это поставщик услуг, который управляет ресурсом.NetworkPerformanceOptions -> (структура)
Содержит параметры шаблона запуска для сетевых параметров производительности вашего экземпляра.
BandwidthWeighting -> (строка)
Operator -> (структура)
Сущность, которая управляет шаблоном запуска.
Managed -> (булево)
true, ресурс управляется поставщиком услуг.Principal -> (строка)
managed равно true, то возвращается principal. Principal - это поставщик услуг, который управляет ресурсом.NextToken -> (строка)
null, когда больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.