Spec-Zone.ru › AWS CLI v2

[ aws . emr ]

добавить-группы-инстансов

Описание

Добавляет группу инстансов к работающему кластеру.

Синтаксис

  add-instance-groups
--cluster-id <value>
--instance-groups <value> [<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 (строка)

Уникальная строка, идентифицирующая кластер. Команда create-cluster возвращает этот идентификатор. Вы можете использовать команду list-clusters для получения идентификаторов кластеров.

--instance-groups (список)

Указывает количество и тип экземпляров Amazon EC2, которые нужно создать для каждого типа узла в кластере, используя однородные группы экземпляров. Вы можете указать либо --instance-groups, либо --instance-fleets, но не оба сразу. Дополнительную информацию см. в разделе руководства по управлению EMR:

https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-instance-group-configuration.html

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

Если вы указываете структуры JSON в строчном виде, заключите весь блок аргументов InstanceGroupType в одинарные кавычки.

Каждый блок InstanceGroupType принимает следующие строчные аргументы. Дополнительные аргументы показаны в [квадратных скобках].

  • [Name] - Необязательное понятное имя для группы экземпляров.
  • InstanceGroupType - MASTER, CORE или TASK.
  • InstanceType - Тип экземпляра EC2, например m4.large, используемый для всех узлов в группе экземпляров.
  • InstanceCount - Количество экземпляров EC2 для развертывания в группе экземпляров.
  • [BidPrice] - При указании, указывает, что группа экземпляров использует Spot-инстансы. Это максимальная цена, которую вы готовы заплатить за Spot-инстансы. Укажите OnDemandPrice, чтобы установить значение, равное цене On-Demand, или укажите сумму в USD.
  • [EbsConfiguration] - Указывает дополнительные тома хранения Amazon EBS, подключенные к экземплярам EC2, с использованием структуры JSON в строчном виде.
  • [AutoScalingPolicy] - Указывает политику автоматического масштабирования для группы экземпляров, используя структуру JSON в строчном виде.

(структура)

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

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

InstanceGroupType -> (строка)

Тип группы экземпляров в кластере.

BidPrice -> (строка)

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

InstanceType -> (строка)

Тип экземпляра Amazon EC2 для всех экземпляров в группе экземпляров.

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

Целевое количество экземпляров Amazon EC2 для группы экземпляров

CustomAmiId -> (строка)

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

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

Настройка EBS, которая будет связана с группой экземпляров.

EbsOptimized -> (булево)

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

EbsBlockDeviceConfigs -> (список)

(структура)

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

Спецификация тома EBS, которая будет создана и подключена ко всем экземплярам в этой группе экземпляров.

VolumeType -> (строка)

Тип тома EBS, подключенного ко всем экземплярам в группе экземпляров. Допустимые типы: gp2, io1 и standard.

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

Размер тома EBS в ГБ, подключенного ко всем экземплярам в группе экземпляров.

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

IOPS тома EBS, подключенного ко всем экземплярам в группе экземпляров.

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

Пропускная способность тома EBS, подключенного ко всем экземплярам в группе экземпляров.

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

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

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

Политика автоматического масштабирования, которая будет связана с группой экземпляров.

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

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

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

Минимальное значение для масштабирования экземпляров при масштабировании.

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

Максимальное значение для масштабирования экземпляров при масштабировании.

Rules -> (список)

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

(структура)

Name -> (строка)

Имя правила автоматического масштабирования.

Description -> (строка)

Описание правила автоматического масштабирования.

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

Действие, связанное с правилом автоматического масштабирования.

Market -> (строка)

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

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

Конфигурация простого масштабирования, которая будет связана с действием автоматического масштабирования.

AdjustmentType -> (строка)

Указывает, как интерпретируется параметр ScalingAdjustment.

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

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

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

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

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

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

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

Сигнализация, регистрируемая в CloudWatch, для запуска действий масштабирования.

ComparisonOperator -> (строка)

Арифметическая операция, используемая при сравнении указанного Statistic и Threshold.

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

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

MetricName -> (строка)

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

Namespace -> (строка)

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

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

Период в секундах, в течение которого применяется указанная статистика.

Statistic -> (строка)

Статистика, применяемая к метрике, связанной с сигнализацией.

Threshold -> (дробное число)

Значение, с которым сравнивается указанная статистика.

Unit -> (строка)

Единица измерения статистики.

Dimensions -> (список)

Размеры метрики, связанной с сигнализацией.

(структура)

Key -> (строка)

Ключ измерения.

Value -> (строка)

Значение измерения.

Configurations -> (список)

Конфигурации приложений группы экземпляров.

(структура)

Classification -> (строка)

Имя классификации конфигурации приложения

Properties -> (отображение)

Свойства конфигурации приложения

ключ -> (строка)

Ключ конфигурации

значение -> (строка)

Значение конфигурации

Configurations -> (список)

Конфигурации приложений группы экземпляров.

(структура)

Classification -> (строка)

Имя классификации конфигурации приложения

Properties -> (отображение)

Свойства конфигурации приложения

ключ -> (строка)

Ключ конфигурации

значение -> (строка)

Значение конфигурации

JSON Синтаксис:

[
  {
    "Name": "string",
    "InstanceGroupType": "MASTER"|"CORE"|"TASK",
    "BidPrice": "string",
    "InstanceType": "string",
    "InstanceCount": integer,
    "CustomAmiId": "string",
    "EbsConfiguration": {
      "EbsOptimized": true|false,
      "EbsBlockDeviceConfigs": [
        {
          "VolumeSpecification": {
            "VolumeType": "string",
            "SizeInGB": integer,
            "Iops": integer,
            "Throughput": integer
          },
          "VolumesPerInstance": integer
        }
        ...
      ]
    },
    "AutoScalingPolicy": {
      "Constraints": {
        "MinCapacity": integer,
        "MaxCapacity": integer
      },
      "Rules": [
        {
          "Name": "string",
          "Description": "string",
          "Action": {
            "Market": "ON_DEMAND"|"SPOT",
            "SimpleScalingPolicyConfiguration": {
              "AdjustmentType": "CHANGE_IN_CAPACITY"|"PERCENT_CHANGE_IN_CAPACITY"|"EXACT_CAPACITY",
              "ScalingAdjustment": integer,
              "CoolDown": integer
            }
          },
          "Trigger": {
            "CloudWatchAlarmDefinition": {
              "ComparisonOperator": "string",
              "EvaluationPeriods": integer,
              "MetricName": "string",
              "Namespace": "string",
              "Period": integer,
              "Statistic": "string",
              "Threshold": double,
              "Unit": "string",
              "Dimensions": [
                {
                  "Key": "string",
                  "Value": "string"
                }
                ...
              ]
            }
          }
        }
        ...
      ]
    },
    "Configurations": [
      {
        "Classification": "string",
        "Properties": {"string": "string"
          ...},
        "Configurations": [
          {
            "Classification": "string",
            "Properties": {"string": "string"
              ...}
          }
          ...
        ]
      }
      ...
    ]
  }
  ...
]

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

--debug (булево)

Включить отладку регистрации.

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

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

--no-verify-ssl (булево)

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

--no-paginate (булево)

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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 для вывода.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

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

Spec-Zone.ru

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