modify-instance-fleet
Описание
Изменяет целевые емкости On-Demand и Spot для флота экземпляров с указанным InstanceFleetID внутри кластера, указанного с помощью ClusterID. Вызов либо завершается успешно, либо терпит неудачу атомарно.
Примечание
Конфигурация флота экземпляров доступна только в выпусках Amazon EMR 4.8.0 и более поздних, за исключением версий 5.0.x.См. также: Документация API AWS
Синтаксис
modify-instance-fleet
--cluster-id <value>
--instance-fleet <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--cluster-id (строка)
--instance-fleet (структура)
Параметры конфигурации флота экземпляров.
InstanceFleetId -> (строка)
TargetOnDemandCapacity -> (целое число)
TargetSpotCapacity -> (целое число)
ResizeSpecifications -> (структура)
Спецификация изменения размера для флота экземпляров.
SpotResizeSpecification -> (структура)
Спецификация изменения размера для Spot-экземпляров во флоте экземпляров, содержащая стратегию выделения и срок ожидания изменения размера.
TimeoutDurationMinutes -> (целое число)
AllocationStrategy -> (строка)
price-capacity-optimized. Если вы используете Amazon EMR релиз 6.8.0 или ниже, значение по умолчанию — capacity-optimized.OnDemandResizeSpecification -> (структура)
Спецификация изменения размера для On-Demand экземпляров во флоте экземпляров, содержащая стратегию выделения, параметры резервирования емкости и срок ожидания изменения размера.
TimeoutDurationMinutes -> (целое число)
AllocationStrategy -> (строка)
lowest-price.CapacityReservationOptions -> (структура)
Описывает стратегию использования неиспользованных резервирований емкости для удовлетворения спроса на On-Demand емкость.
UsageStrategy -> (строка)
Указывает, использовать ли неиспользованные резервирования емкости для удовлетворения спроса на On-Demand емкость.
Если вы укажете use-capacity-reservations-first, флот будет использовать неиспользованные резервирования емкости для удовлетворения спроса на On-Demand емкость до целевого значения On-Demand емкости. Если несколько пулов экземпляров имеют неиспользованные резервирования емкости, будет применена стратегия выделения On-Demand (lowest-price). Если количество неиспользованных резервирований емкости меньше целевого значения On-Demand емкости, оставшаяся целевая емкость On-Demand будет развернута в соответствии со стратегией выделения On-Demand (lowest-price).
Если значение не указано, флот будет удовлетворять спрос на On-Demand емкость в соответствии с выбранной стратегией выделения On-Demand.
CapacityReservationPreference -> (строка)
Указывает предпочтения резервирования емкости для экземпляра. Возможные предпочтения:
-
open— экземпляр может работать в любом открытом резервировании емкости, которое имеет соответствующие атрибуты (тип экземпляра, платформа, зона доступности). -
none— экземпляр избегает работы в резервировании емкости, даже если оно доступно. Экземпляр работает как On-Demand экземпляр.
CapacityReservationResourceGroupArn -> (строка)
InstanceTypeConfigs -> (список)
Массив объектов InstanceTypeConfig, которые определяют, как Amazon EMR разворачивает Amazon EC2 экземпляры при удовлетворении On-Demand и Spot потребностей. Дополнительная информация в InstanceTypeConfig.
(структура)
Конфигурация типа экземпляра для каждого типа экземпляра во флоте экземпляров, определяющая Amazon EC2 экземпляры, которые Amazon EMR пытается развернуть для удовлетворения целевого On-Demand и Spot объёма. При использовании стратегии выделения вы можете указать не более 30 конфигураций типов экземпляров для флота. Дополнительную информацию о том, как использовать стратегию выделения, см. в Configure Instance Fleets. Без стратегии выделения вы можете указать не более пяти конфигураций типов экземпляров для флота.
Примечание
Конфигурация флота экземпляров доступна только в релизах Amazon EMR 4.8.0 и выше, за исключением версий 5.0.x.InstanceType -> (строка)
m3.xlarge.WeightedCapacity -> (целое число)
BidPrice -> (строка)
InstanceType. Выражается в USD. Если ни BidPrice, ни BidPriceAsPercentageOfOnDemandPrice не предоставлены, BidPriceAsPercentageOfOnDemandPrice по умолчанию равно 100%.BidPriceAsPercentageOfOnDemandPrice -> (двойное)
InstanceType. Выражается числом (например, 20 означает 20%). Если ни BidPrice, ни BidPriceAsPercentageOfOnDemandPrice не предоставлены, BidPriceAsPercentageOfOnDemandPrice по умолчанию равно 100%.EbsConfiguration -> (структура)
Конфигурация Amazon Elastic Block Store (Amazon EBS), подключённая к каждому экземпляру, как определено в InstanceType.
EbsBlockDeviceConfigs -> (список)
Массив спецификаций объёмов Amazon EBS, подключённых к экземпляру кластера.
(структура)
Конфигурация запрошенного устройства EBS, связанного с группой экземпляров, с количеством объёмов, связанных с каждым экземпляром.
VolumeSpecification -> (структура)
Спецификации объёмов EBS, такие как тип объёма, IOPS, размер (GiB) и пропускная способность (MiB/с), которые запрашиваются для объёма EBS, подключённого к Amazon EC2 экземпляру в кластере.
VolumeType -> (строка)
Iops -> (целое число)
SizeInGB -> (целое число)
Throughput -> (целое число)
VolumesPerInstance -> (целое число)
EbsOptimized -> (логическое значение)
Configurations -> (список)
Классификация конфигурации, применяемая при развертывании экземпляров кластера, которая может включать конфигурации для приложений и программного обеспечения, работающих в кластере.
(структура)
Примечание
Amazon EMR версии 4.x или выше.Необязательная спецификация конфигурации, которая может использоваться при развертывании экземпляров кластера, в том числе конфигурации для приложений и программного обеспечения, включенных в Amazon EMR. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле. Подробнее см. Configuring Applications.
Classification -> (строка)
Configurations -> (список)
Список дополнительных конфигураций для применения внутри объекта конфигурации.
(структура)
Примечание
Amazon EMR версии 4.x или выше.Необязательная спецификация конфигурации, которая может использоваться при развертывании экземпляров кластера, в том числе конфигурации для приложений и программного обеспечения, включенных в Amazon EMR. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле. Подробнее см. Configuring Applications.
Classification -> (строка)
Properties -> (карта)
Набор свойств, указанных внутри классификации конфигурации.
key -> (строка)
value -> (строка)
Properties -> (карта)
Набор свойств, указанных внутри классификации конфигурации.
key -> (строка)
value -> (строка)
CustomAmiId -> (строка)
Priority -> (двойное)
Context -> (строка)
Синтаксис JSON:
{
"InstanceFleetId": "string",
"TargetOnDemandCapacity": integer,
"TargetSpotCapacity": integer,
"ResizeSpecifications": {
"SpotResizeSpecification": {
"TimeoutDurationMinutes": integer,
"AllocationStrategy": "capacity-optimized"|"price-capacity-optimized"|"lowest-price"|"diversified"|"capacity-optimized-prioritized"
},
"OnDemandResizeSpecification": {
"TimeoutDurationMinutes": integer,
"AllocationStrategy": "lowest-price"|"prioritized",
"CapacityReservationOptions": {
"UsageStrategy": "use-capacity-reservations-first",
"CapacityReservationPreference": "open"|"none",
"CapacityReservationResourceGroupArn": "string"
}
}
},
"InstanceTypeConfigs": [
{
"InstanceType": "string",
"WeightedCapacity": integer,
"BidPrice": "string",
"BidPriceAsPercentageOfOnDemandPrice": double,
"EbsConfiguration": {
"EbsBlockDeviceConfigs": [
{
"VolumeSpecification": {
"VolumeType": "string",
"Iops": integer,
"SizeInGB": integer,
"Throughput": integer
},
"VolumesPerInstance": integer
}
...
],
"EbsOptimized": true|false
},
"Configurations": [
{
"Classification": "string",
"Configurations": [
{
"Classification": "string",
"Configurations": ,
"Properties": {"string": "string"
...}
}
...
],
"Properties": {"string": "string"
...}
}
...
],
"CustomAmiId": "string",
"Priority": double
}
...
],
"Context": "string"
}
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он валидирует входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (логическое значение)
Включить отладку логов.
--endpoint-url (строка)
Переопределить URL по умолчанию команды на заданный URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверит SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из вашего файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включить
- выключить
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить вывод кли-пейджера.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запрошение параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительная информация приведена в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.
Изменение целевых мощностей группы экземпляров
В этом примере целевые мощности On-Demand и Spot изменяются на 1 для указанной группы экземпляров.
Команда:
aws emr modify-instance-fleet --cluster-id 'j-12ABCDEFGHI34JK' --instance-fleet InstanceFleetId='if-2ABC4DEFGHIJ4',TargetOnDemandCapacity=1,TargetSpotCapacity=1
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.