Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

get-launch-template-data

Описание

Получает данные конфигурации указанного экземпляра. Вы можете использовать эти данные для создания шаблона запуска.

Этот действия вызывает другие действия describe для получения информации об экземпляре. В зависимости от конфигурации вашего экземпляра, вам может потребоваться разрешить следующие действия в вашей политике IAM: DescribeSpotInstanceRequests , DescribeInstanceCreditSpecifications , DescribeVolumes , и DescribeInstanceAttribute . Или вы можете разрешить describe* в зависимости от требований к экземпляру.

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

Синтаксис

  get-launch-template-data
[--dry-run | --no-dry-run]
--instance-id <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 .

--instance-id (string)

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

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

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

Глобальные параметры

--debug (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

Область, которую нужно использовать. Переопределяет настройки config/env.

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки config/env.

--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-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Для получения данных экземпляра для шаблона запуска

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

Команда:

aws ec2 get-launch-template-data --instance-id i-0123d646e8048babc --query 'LaunchTemplateData'

Вывод:

{
      "Monitoring": {},
      "ImageId": "ami-8c1be5f6",
      "BlockDeviceMappings": [
          {
              "DeviceName": "/dev/xvda",
              "Ebs": {
                  "DeleteOnTermination": true
              }
          }
      ],
      "EbsOptimized": false,
      "Placement": {
          "Tenancy": "default",
          "GroupName": "",
          "AvailabilityZone": "us-east-1a"
      },
      "InstanceType": "t2.micro",
      "NetworkInterfaces": [
          {
              "Description": "",
              "NetworkInterfaceId": "eni-35306abc",
              "PrivateIpAddresses": [
                  {
                      "Primary": true,
                      "PrivateIpAddress": "10.0.0.72"
                  }
              ],
              "SubnetId": "subnet-7b16de0c",
              "Groups": [
                  "sg-7c227019"
              ],
              "Ipv6Addresses": [
                  {
                      "Ipv6Address": "2001:db8:1234:1a00::123"
                  }
              ],
              "PrivateIpAddress": "10.0.0.72"
          }
      ]
}

Вывод

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

Данные экземпляра.

KernelId -> (строка)

Идентификатор ядра, если применимо.

EbsOptimized -> (булево)

Указывает, оптимизирован ли экземпляр для ввода-вывода Amazon EBS.

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

Профиль IAM экземпляра.

Arn -> (строка)

Amazon Resource Name (ARN) профиля экземпляра.

Name -> (строка)

Имя профиля экземпляра.

BlockDeviceMappings -> (список)

Сопоставления блочных устройств.

(структура)

Описывает сопоставление блочного устройства.

DeviceName -> (строка)

Имя устройства.

VirtualName -> (строка)

Виртуальное имя устройства (ephemeralN).

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

Информация о блочном устройстве для тома EBS.

Encrypted -> (булево)

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

DeleteOnTermination -> (булево)

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

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

Количество операций ввода-вывода в секунду (IOPS), которые поддерживает том.

KmsKeyId -> (строка)

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

SnapshotId -> (строка)

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

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

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

VolumeType -> (строка)

Тип тома.

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

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

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

Установленная для тома скорость инициализации тома Amazon EBS (скорость инициализации тома) в MiB/с. Если скорость инициализации тома не была указана, значение равно null.

NoDevice -> (строка)

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

NetworkInterfaces -> (список)

Сетевые интерфейсы.

(структура)

Описывает сетевой интерфейс.

AssociateCarrierIpAddress -> (булево)

Указывает, нужно ли связать адрес Carrier IP с eth0 для нового сетевого интерфейса.

Используйте этот параметр при запуске экземпляра в зоне Wavelength и желании связать адрес Carrier IP с сетевым интерфейсом. Дополнительную информацию об адресах Carrier IP см. в Wavelength Developer Guide.

AssociatePublicIpAddress -> (булево)

Указывает, нужно ли связать общедоступный IPv4-адрес с eth0 для нового сетевого интерфейса.

Amazon Web Services взимает плату за все общедоступные IPv4-адреса, включая общедоступные IPv4-адреса, связанные с работающими экземплярами и адресами Elastic IP. Дополнительную информацию см. на странице ценообразования Amazon VPC в вкладке Общедоступный IPv4-адрес.

DeleteOnTermination -> (булево)

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

Description -> (строка)

Описание сетевого интерфейса.

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

Индекс устройства для подключения сетевого интерфейса.

Groups -> (список)

Идентификаторы одного или нескольких сетевых групп.

(строка)

InterfaceType -> (строка)

Тип сетевого интерфейса.

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

Количество IPv6-адресов для сетевого интерфейса.

Ipv6Addresses -> (список)

IPv6-адреса для сетевого интерфейса.

(структура)

Описывает IPv6-адрес.

Ipv6Address -> (строка)

IPv6-адрес.

IsPrimaryIpv6 -> (булево)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, основным IPv6-адресом. При включении IPv6-адреса GUA в качестве основного IPv6-адреса первый IPv6 GUA станет основным IPv6-адресом до завершения работы экземпляра или отсоединения сетевого интерфейса. Дополнительную информацию см. в RunInstances.

NetworkInterfaceId -> (строка)

Идентификатор сетевого интерфейса.

PrivateIpAddress -> (строка)

Основной частный IPv4-адрес сетевого интерфейса.

PrivateIpAddresses -> (список)

Один или несколько частных IPv4-адресов.

(структура)

Описывает дополнительный частный IPv4-адрес для сетевого интерфейса.

Primary -> (булево)

Указывает, является ли частный IPv4-адрес основным частным IPv4-адресом. Только один IPv4-адрес может быть назначен в качестве основного.

PrivateIpAddress -> (строка)

Частный IPv4-адрес.

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

Количество дополнительных частных IPv4-адресов для сетевого интерфейса.

SubnetId -> (строка)

Идентификатор подсети для сетевого интерфейса.

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

Индекс сетевой карты.

Ipv4Prefixes -> (список)

Один или несколько IPv4-префиксов, назначенных сетевому интерфейсу.

(структура)

Информация об IPv4-делегированных префиксах, назначенных сетевому интерфейсу.

Ipv4Prefix -> (строка)

IPv4-делегированные префиксы, назначенные сетевому интерфейсу.

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

Количество IPv4-префиксов, автоматически назначенных Amazon Web Services сетевому интерфейсу.

Ipv6Prefixes -> (список)

Один или несколько IPv6-префиксов, назначенных сетевому интерфейсу.

(структура)

Информация об IPv6-делегированных префиксах, назначенных сетевому интерфейсу.

Ipv6Prefix -> (строка)

IPv6-делегированные префиксы, назначенные сетевому интерфейсу.

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

Количество IPv6-префиксов, автоматически назначенных Amazon Web Services сетевому интерфейсу.

PrimaryIpv6 -> (булево)

Основной IPv6-адрес сетевого интерфейса. При включении IPv6-адреса GUA в качестве основного IPv6-адреса первый IPv6 GUA станет основным IPv6-адресом до завершения работы экземпляра или отсоединения сетевого интерфейса. Дополнительную информацию об основных IPv6-адресах см. в RunInstances.

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

Содержит параметры ENA Express для экземпляров, запущенных из шаблона запуска.

EnaSrdEnabled -> (булево)

Указывает, включен ли ENA Express для сетевого интерфейса.

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

Настраивает ENA Express для UDP-сетевого трафика.

EnaSrdUdpEnabled -> (булево)

Указывает, использует ли UDP-трафик в экземпляре ENA Express. Для указания этого параметра необходимо предварительно включить ENA Express.

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

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

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

Таймаут (в секундах) для неактивных TCP-соединений в состоянии установленного соединения. Минимальное значение: 60 секунд. Максимальное значение: 432000 секунд (5 дней). По умолчанию: 432000 секунд. Рекомендуемое значение: меньше 432000 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, которые видели трафик только в одном направлении или в одной транзакции запроса-ответа. Минимальное значение: 30 секунд. Максимальное значение: 60 секунд. По умолчанию: 30 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, классифицируемых как потоки, которые видели более одной транзакции запроса-ответа. Минимальное значение: 60 секунд. Максимальное значение: 180 секунд (3 минуты). По умолчанию: 180 секунд.

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

Количество очередей ENA, созданных с экземпляром.

ImageId -> (строка)

Идентификатор AMI или параметр Systems Manager. Параметр Systems Manager разрешится в ID AMI при запуске экземпляра.

Значение зависит от того, что было указано в запросе. Возможные значения:

  • Если в запросе был указан ID AMI, то это ID AMI.
  • Если в запросе был указан параметр Systems Manager, и ResolveAlias был настроен как true, то это ID AMI, которому параметр сопоставлен в хранилище параметров.
  • Если в запросе был указан параметр Systems Manager, и ResolveAlias был настроен как false, то это значение параметра.

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

InstanceType -> (строка)

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

KeyName -> (строка)

Имя пары ключей.

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

Мониторинг экземпляра.

Enabled -> (булево)

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

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

Размещение экземпляра.

AvailabilityZone -> (строка)

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

Affinity -> (строка)

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

GroupName -> (строка)

Имя группы размещения для экземпляра.

HostId -> (строка)

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

Tenancy -> (строка)

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

SpreadDomain -> (строка)

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

HostResourceGroupArn -> (строка)

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

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

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

GroupId -> (строка)

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

RamDiskId -> (строка)

Идентификатор RAM-диска, если применимо.

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 для ускорения рабочих нагрузок инференса глубокого обучения (DL).

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

(структура)

Примечание

Amazon Elastic Inference больше недоступен.

Описание ускорителя Elastic Inference.

Type -> (строка)

Тип ускорителя Elastic Inference. Возможные значения: eia1.medium, eia1.large и eia1.xlarge.

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

Количество ускорителей Elastic Inference, подключаемых к экземпляру.

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

SecurityGroupIds -> (список)

ID групп безопасности.

(строка)

SecurityGroups -> (список)

Имена групп безопасности.

(строка)

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

Рыночные (покупки) опции для экземпляров.

MarketType -> (строка)

Тип рынка.

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

Опции для Spot-экземпляров.

MaxPrice -> (строка)

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

SpotInstanceType -> (строка)

Тип запроса Spot-экземпляра.

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

Требуемая продолжительность Spot-экземпляров (также известная как Spot-блоки) в минутах. Это значение должно быть кратно 60 (60, 120, 180, 240, 300 или 360).

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

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

InstanceInterruptionBehavior -> (строка)

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

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

Опция кредита для использования ЦП экземпляра.

CpuCredits -> (строка)

Опция кредита для использования ЦП экземпляра типа T.

Допустимые значения: standard | unlimited

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

Опции ЦП для экземпляра. Более подробная информация доступна в разделе Опции ЦП для экземпляров Amazon EC2 в руководстве пользователя Amazon EC2.

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

Количество ядер ЦП для экземпляра.

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

Количество потоков на ядро ЦП.

AmdSevSnp -> (строка)

Указывает, включен ли экземпляр для AMD SEV-SNP. Более подробная информация доступна в разделе AMD SEV-SNP для экземпляров Amazon EC2.

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

Информация об опции назначения резервации емкости.

CapacityReservationPreference -> (строка)

Указывает предпочтения экземпляра для резервации емкости. Возможные предпочтения включают:

  • open — экземпляр может работать в любой резервации емкости open, имеющей соответствующие атрибуты (тип экземпляра, платформа, зона доступности).
  • none — экземпляр избегает работы в резервации емкости, даже если она доступна. Экземпляр работает с емкостью On-Demand.

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

Информация о целевой резервации емкости или группе резервации емкости.

CapacityReservationId -> (строка)

ID целевой резервации емкости.

CapacityReservationResourceGroupArn -> (строка)

ARN целевой группы резервации емкости.

LicenseSpecifications -> (список)

Настройки лицензий.

(структура)

Описание конфигурации лицензии.

LicenseConfigurationArn -> (строка)

Amazon Resource Name (ARN) конфигурации лицензии.

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; в противном случае, он не включен для Amazon Web Services Nitro Enclaves.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

CpuManufacturers -> (список)

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

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

Примечание

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

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

(string)

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

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

По умолчанию: нет минимальных и максимальных лимитов

Min -> (double)

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

Max -> (double)

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

ExcludedInstanceTypes -> (список)

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

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

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

Примечание

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

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

(string)

InstanceGenerations -> (список)

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

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

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

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

(string)

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

[Защита цены] Пороговое значение защиты цены для Spot Instances в процентах выше указанной цены 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 Instances, что означает, что вы хотите учитывать все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например 999999 .

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

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

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

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

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

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

Примечание

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

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

BareMetal -> (string)

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

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

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

BurstablePerformance -> (string)

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

  • Чтобы включить типы экземпляров burstable performance, укажите included .
  • Чтобы требовать только типы экземпляров burstable performance, укажите required .
  • Чтобы исключить типы экземпляров burstable performance, укажите excluded .

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

RequireHibernateSupport -> (boolean)

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

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

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

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

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

По умолчанию: нет минимальных и максимальных лимитов

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

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

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

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

LocalStorage -> (string)

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

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

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

LocalStorageTypes -> (список)

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

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

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

(string)

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

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

По умолчанию: нет минимальных и максимальных лимитов

Min -> (double)

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

Max -> (double)

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

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

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

По умолчанию: нет минимальных и максимальных лимитов

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

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

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

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

AcceleratorTypes -> (список)

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

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

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

(string)

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 .
  • Для типов экземпляров с программируемыми логическими чипами Xilinx VU9P укажите vu9p .
  • Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .

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

(строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AllowedInstanceTypes -> (список)

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

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

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

Примечание

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

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

(строка)

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

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

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

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

Примечание

Можно указать только один из 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 -> (булево)

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

EnableResourceNameDnsAAAARecord -> (булево)

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

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

Параметры обслуживания вашего экземпляра.

AutoRecovery -> (строка)

Отключает поведение автоматического восстановления вашего экземпляра или устанавливает его по умолчанию.

DisableApiStop -> (булево)

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

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

Сущность, управляющая шаблоном запуска.

Managed -> (булево)

Если true , ресурс управляется поставщиком услуг.

Principal -> (строка)

Если managed равен true , возвращается управляющий ресурсом поставщик услуг.

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

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

BandwidthWeighting -> (строка)

При настройке весов пропускной способности сети вы можете увеличить базовый объём пропускной способности для сети или EBS на 25%. Общий доступный базовый объём пропускной способности для вашего экземпляра остаётся неизменным. По умолчанию используется стандартная настройка пропускной способности для вашего типа экземпляра.

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

Spec-Zone.ru

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