describe-fleets

Описание

Описывает указанный EC2 флот или все ваши EC2 флоты.

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

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

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

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

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

Синтаксис

  describe-fleets
[--dry-run | --no-dry-run]
[--fleet-ids <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

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

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

--fleet-ids (список)

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

Примечание

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

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Фильтры.

activity-status — Прогресс EC2 флота (error | pending-fulfillment | pending-termination | fulfilled).
excess-capacity-termination-policy — Указывает, следует ли завершать работу запущенных экземпляров, если целевая емкость уменьшена ниже текущего размера EC2 флота (true | false).
fleet-state — Состояние EC2 флота (submitted | active | deleted | failed | deleted-running | deleted-terminating | modifying).
replace-unhealthy-instances — Указывает, должен ли EC2 флот заменять неисправные экземпляры (true | false).
type — Тип запроса (instant | request | maintain).

(структура)

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

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

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

Имя -> (строка)

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

Значения -> (список)

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

(строка)

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

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

Синтаксис JSON:

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

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

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

Маркер для указания точки начала постраничной навигации. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

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

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

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

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

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

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

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

--debug (boolean)

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

--endpoint-url (строка)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (строка)

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

json
text
таблица
yaml
yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

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

--color (строка)

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

включить
выключить
автоматически

--no-sign-request (boolean)

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

--ca-bundle (строка)

Сборка сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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 (boolean)

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

--cli-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Для описания EC2 флота

Следующий пример описывает указанный EC2 флот.

aws ec2 describe-fleets \
    --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE

Вывод:

{
    "Fleets": [
        {
            "ActivityStatus": "pending_fulfillment",
            "CreateTime": "2020-09-01T18:26:05.000Z",
            "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE",
            "FleetState": "active",
            "ExcessCapacityTerminationPolicy": "termination",
            "FulfilledCapacity": 0.0,
            "FulfilledOnDemandCapacity": 0.0,
            "LaunchTemplateConfigs": [
                {
                    "LaunchTemplateSpecification": {
                        "LaunchTemplateId": "lt-0e632f2855a979cd5",
                        "Version": "1"
                    }
                }
            ],
            "TargetCapacitySpecification": {
                "TotalTargetCapacity": 2,
                "OnDemandTargetCapacity": 0,
                "SpotTargetCapacity": 2,
                "DefaultTargetCapacityType": "spot"
            },
            "TerminateInstancesWithExpiration": false,
            "Type": "maintain",
            "ReplaceUnhealthyInstances": false,
            "SpotOptions": {
                "AllocationStrategy": "lowestPrice",
                "InstanceInterruptionBehavior": "terminate",
                "InstancePoolsToUseCount": 1
            },
            "OnDemandOptions": {
                "AllocationStrategy": "lowestPrice"
            }
        }
    ]
}

Для получения дополнительной информации см. Управление EC2 флотом в руководстве пользователя Amazon Elastic Compute Cloud для Linux-экземпляров.

Вывод

NextToken -> (строка)

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

Fleets -> (список)

Информация о флотах EC2.

(структура)

Описание флота EC2.

ActivityStatus -> (строка)

Прогресс флота EC2. Если произошла ошибка, статус равен error. После размещения всех запросов статус равен pending_fulfillment. Если размер флота EC2 равен или превышает его целевую емкость, статус равен fulfilled. Если размер флота EC2 уменьшается, статус равен pending_termination, пока экземпляры не завершат работу.

CreateTime -> (временная метка)

Дата и время создания флота EC2.

FleetId -> (строка)

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

FleetState -> (строка)

Состояние флота EC2.

ClientToken -> (строка)

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

Ограничения: Максимальная длина 64 символа ASCII

ExcessCapacityTerminationPolicy -> (строка)

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

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

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

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

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

Количество единиц, выполненных по этому запросу по сравнению с заданной целевой емкостью On-Demand.

LaunchTemplateConfigs -> (список)

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

(структура)

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

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

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

LaunchTemplateId -> (строка)

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

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

LaunchTemplateName -> (строка)

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

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

Version -> (строка)

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

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

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

Overrides -> (список)

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

(структура)

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

InstanceType -> (строка)

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

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

Примечание

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

MaxPrice -> (строка)

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

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

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

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

SubnetId -> (строка)

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

AvailabilityZone -> (строка)

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

GroupName -> (строка)

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

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

``` END_OF_DOCUMENT_MARKER

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

CpuManufacturers -> (список)

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

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

Примечание

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

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

(строка)

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

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

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

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

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

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

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

ExcludedInstanceTypes -> (список)

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

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

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

Примечание

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

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

(строка)

InstanceGenerations -> (список)

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

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

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

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

(строка)

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

Примечание

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

BareMetal -> (строка)

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

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

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

BurstablePerformance -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

LocalStorage -> (строка)

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

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

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

LocalStorageTypes -> (список)

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

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

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

(строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AcceleratorTypes -> (список)

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

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

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

(строка)

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

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

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

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

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

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

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

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

AcceleratorManufacturers -> (список)

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

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

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

(строка)

AcceleratorNames -> (список)

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

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

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

(строка)

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

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

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

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 .

ImageId -> (строка)

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

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

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

``resolve:ssm:public-parameter ``

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

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

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

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

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

Примечание

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

BlockDeviceMappings -> (список)

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

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

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

(структура)

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

DeviceName -> (строка)

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

VirtualName -> (строка)

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

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

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

Encrypted -> (булево)

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

DeleteOnTermination -> (булево)

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

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

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

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

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

KmsKeyId -> (строка)

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

SnapshotId -> (строка)

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

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

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

VolumeType -> (строка)

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

NoDevice -> (строка)

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

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

Количество единиц для запроса. Вы можете задать целевую емкость в терминах экземпляров или в терминах характеристик производительности, которые важны для вашей рабочей нагрузки приложения, таких как vCPU, память или ввод/вывод. Если тип запроса — maintain, вы можете указать целевую емкость 0 и добавить емкость позже.

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

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

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

Количество единиц On-Demand для запроса. Если вы указываете целевую емкость для единиц Spot, вы не можете указать целевую емкость для единиц On-Demand.

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

Максимальное количество единиц Spot для запуска. Если вы указываете целевую емкость для единиц On-Demand, вы не можете указать целевую емкость для единиц Spot.

DefaultTargetCapacityType -> (строка)

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

TargetCapacityUnitType -> (строка)

Единица для целевой емкости.

TerminateInstancesWithExpiration -> (булево)

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

Type -> (строка)

Тип запроса. Указывает, будет ли EC2 Fleet только requests целевую емкость или также попытается maintain ее. Если вы запрашиваете определенную целевую емкость, EC2 Fleet только размещает необходимые запросы; он не пытается пополнить экземпляры в случае уменьшения емкости и не отправляет запросы в альтернативных пулах емкости в случае ее недоступности. Для поддержания определенной целевой емкости EC2 Fleet размещает необходимые запросы для достижения этой целевой емкости. Он также автоматически пополняет любые прерванные Spot-экземпляры. По умолчанию: maintain.

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

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

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

Дата и время окончания запроса в формате UTC (например, YYYY-MM-DD T*ЧЧ* :ММ :СС Z). На этом этапе новые запросы на экземпляры не размещаются и не могут выполнить запрос. По умолчанию дата окончания — через 7 дней от текущей даты.

ReplaceUnhealthyInstances -> (булево)

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

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

Настройка экземпляров Spot в флоте EC2.

AllocationStrategy -> (строка)

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

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

capacity-optimized

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

diversified

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

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

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

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

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

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

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

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

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

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

ReplacementStrategy -> (строка)

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

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

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

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

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

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

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

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

InstanceInterruptionBehavior -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MaxTotalPrice -> (строка)

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

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

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

Примечание

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

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

Стратегия распределения экземпляров On-Demand во флоте EC2.

AllocationStrategy -> (строка)

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

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

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

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

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

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

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

UsageStrategy -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

MaxTotalPrice -> (строка)

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

Примечание

Tags -> (список)

Теги для ресурса флота EC2.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

Errors -> (список)

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

(структура)

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

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

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

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

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

LaunchTemplateId -> (строка)

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

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

LaunchTemplateName -> (строка)

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

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

Version -> (строка)

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

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

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

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

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

InstanceType -> (строка)

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

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

Примечание

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

MaxPrice -> (строка)

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

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

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

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

SubnetId -> (строка)

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

AvailabilityZone -> (строка)

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

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

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

Примечание

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

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

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

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

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

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

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

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

GroupName -> (строка)

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

CpuManufacturers -> (список)

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

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

Примечание

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

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

(строка)

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

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

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

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

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

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

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

ExcludedInstanceTypes -> (список)

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

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

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

Примечание

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

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

(строка)

InstanceGenerations -> (список)

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

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

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

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

(строка)

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

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

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

Если вы установите TargetCapacityUnitType на TargetCapacityUnitType или 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 -> (целое число)

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

AcceleratorManufacturers -> (список)

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

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

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

(строка)

AcceleratorNames -> (список)

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

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

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

(строка)

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

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

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

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 .

ImageId -> (строка)

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

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

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

``resolve:ssm:public-parameter ``

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

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

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

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

Примечание

BlockDeviceMappings -> (список)

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

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

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

(структура)

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

DeviceName -> (строка)

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

VirtualName -> (строка)

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

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

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

Encrypted -> (булево)

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

DeleteOnTermination -> (булево)

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

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

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

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

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

KmsKeyId -> (строка)

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

SnapshotId -> (строка)

ID снимка.

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

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

VolumeType -> (строка)

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

NoDevice -> (строка)

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

Lifecycle -> (строка)

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

ErrorCode -> (строка)

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

ErrorMessage -> (строка)

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

Instances -> (список)

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

(структура)

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

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

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

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

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

LaunchTemplateId -> (строка)

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

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

LaunchTemplateName -> (строка)

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

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

Version -> (строка)

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

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

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

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

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

InstanceType -> (строка)

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

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

Примечание

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

MaxPrice -> (строка)

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

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

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

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

SubnetId -> (строка)

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

AvailabilityZone -> (строка)

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

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

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

Примечание

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

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

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

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

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

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

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

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

GroupName -> (строка)

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

CpuManufacturers -> (список)

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

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

Примечание

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

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

(строка)

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

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

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

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

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

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

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

ExcludedInstanceTypes -> (список)

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

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

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

Примечание

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

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

(строка)

InstanceGenerations -> (список)

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

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

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

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

(строка)

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

Примечание

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

BareMetal -> (строка)

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

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

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

BurstablePerformance -> (строка)

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

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

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

RequireHibernateSupport -> (булево)

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

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

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

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

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

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

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

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

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

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

LocalStorage -> (строка)

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

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

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

LocalStorageTypes -> (список)

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

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

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

(строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AcceleratorTypes -> (список)

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

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

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

(строка)

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

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

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

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

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

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

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

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

AcceleratorManufacturers -> (список)

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

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

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

(строка)

AcceleratorNames -> (список)

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

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

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

(строка)

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

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

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

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

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

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

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

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

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

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

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

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

ImageId -> (строка)

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

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

``resolve:ssm:public-parameter ``

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

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

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

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

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

Примечание

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

BlockDeviceMappings -> (список)

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

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

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

(структура)

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

DeviceName -> (строка)

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

VirtualName -> (строка)

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

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

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

Encrypted -> (булево)

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

DeleteOnTermination -> (булево)

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

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

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

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

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

KmsKeyId -> (строка)

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

SnapshotId -> (строка)

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

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

Размер тома в ГиБ.

VolumeType -> (строка)

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

NoDevice -> (строка)

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

Lifecycle -> (строка)

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

InstanceIds -> (список)

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

(строка)

InstanceType -> (строка)

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

Platform -> (строка)

Значение равно windows для экземпляров Windows в EC2 Fleet. В противном случае значение пустое.

Context -> (строка)

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

END_OF_DOCUMENT_MARKER