Spec-Zone.ru › AWS CLI v2

[ aws . emr ]

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 -> (целое число)

Целевое количество On-Demand единиц для флота экземпляров. Для получения дополнительной информации см. InstanceFleetConfig$TargetOnDemandCapacity.

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

Целевое количество Spot единиц для флота экземпляров. Дополнительную информацию см. в InstanceFleetConfig$TargetSpotCapacity.

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

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

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

Спецификация изменения размера для Spot-экземпляров во флоте экземпляров, содержащая стратегию выделения и срок ожидания изменения размера.

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

Срок ожидания изменения размера Spot-экземпляров в минутах. Если Spot-экземпляры не будут развернуты в течение этого времени, процесс изменения размера остановит развертывание Spot-экземпляров. Минимальное значение — 5 минут, максимальное — 10 080 минут (7 дней). Срок ожидания применяется ко всем процессам изменения размера для флота экземпляров. Изменение размера может быть инициировано Amazon EMR управляемой масштабированием, пользователем (через консоль Amazon EMR, Amazon EMR CLI modify-instance-fleet или API Amazon EMR SDK ModifyInstanceFleet) или Amazon EMR из-за возврата Amazon EC2 Spot.

AllocationStrategy -> (строка)

Указывает стратегию выделения для запуска Spot-экземпляров при изменении размера. Если вы используете Amazon EMR релиз 6.9.0 или выше, значение по умолчанию — price-capacity-optimized. Если вы используете Amazon EMR релиз 6.8.0 или ниже, значение по умолчанию — capacity-optimized.

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

Спецификация изменения размера для On-Demand экземпляров во флоте экземпляров, содержащая стратегию выделения, параметры резервирования емкости и срок ожидания изменения размера.

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

Срок ожидания изменения размера On-Demand экземпляров в минутах. Если On-Demand экземпляры не будут развернуты в течение этого времени, процесс изменения размера остановится. Минимальное значение — 5 минут, максимальное — 10 080 минут (7 дней). Срок ожидания применяется ко всем процессам изменения размера для флота экземпляров. Изменение размера может быть инициировано Amazon EMR управляемой масштабированием, пользователем (через консоль Amazon EMR, Amazon EMR CLI modify-instance-fleet или API Amazon EMR SDK ModifyInstanceFleet) или Amazon EMR из-за возврата Amazon EC2 Spot.

AllocationStrategy -> (строка)

Указывает стратегию выделения для запуска On-Demand экземпляров при изменении размера. Значение по умолчанию — 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 -> (строка)

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

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 -> (строка)

Тип Amazon EC2 экземпляра, например, m3.xlarge.

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

Количество единиц, которое развернутый экземпляр этого типа предоставляет для удовлетворения целевых объёмов, определённых в InstanceFleetConfig. Это значение равно 1 для главного флота экземпляров и должно быть 1 или больше для флотов основных и задачи экземпляров. По умолчанию равно 1, если не указано другое.

BidPrice -> (строка)

Цена ставки для каждого типа Amazon EC2 Spot экземпляра, как определено в InstanceType. Выражается в USD. Если ни BidPrice, ни BidPriceAsPercentageOfOnDemandPrice не предоставлены, BidPriceAsPercentageOfOnDemandPrice по умолчанию равно 100%.

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

Цена ставки в процентах от цены On-Demand для каждого типа Amazon EC2 Spot экземпляра, как определено в 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 -> (строка)

Тип объёма. Поддерживаемые типы объёмов: gp3, gp2, io1, st1, sc1 и стандартный.

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

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

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

Размер объёма в гибибайтах (GiB). Может принимать значения от 1 до 1024. Если тип объёма EBS-оптимизирован, минимальное значение равно 10.

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

Пропускная способность в мебибайтах в секунду (MiB/с). Этот необязательный параметр может принимать значения от 125 до 1000 и действителен только для объёмов gp3.

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

Количество объёмов EBS со специфической конфигурацией объёма, связанных с каждым экземпляром в группе экземпляров.

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

Указывает, является ли объём Amazon EBS EBS-оптимизированным. По умолчанию — false. Вы должны явно установить это значение в true, чтобы включить EBS-оптимизацию для EC2 экземпляра.

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 -> (строка)

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

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

Приоритет, с которым Amazon EMR запускает Amazon EC2 экземпляры с этим типом экземпляра. Приоритет начинается с 0, что является наивысшим приоритетом. Amazon EMR рассматривает экземпляры с высшим приоритетом в первую очередь.

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.

Spec-Zone.ru

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