Spec-Zone.ru › AWS CLI v2

[ aws . pcs ]

update-compute-node-group

Описание

Обновляет группу вычислительных узлов. Вы можете обновить многие поля, относящиеся к вашей группе вычислительных узлов, включая конфигурации для сети, вычислительных узлов и настройки, специфичные для вашего планировщика (например, Slurm).

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

Синтаксис

  update-compute-node-group
--cluster-identifier <value>
--compute-node-group-identifier <value>
[--ami-id <value>]
[--subnet-ids <value>]
[--custom-launch-template <value>]
[--purchase-option <value>]
[--spot-options <value>]
[--scaling-configuration <value>]
[--iam-instance-profile-arn <value>]
[--slurm-configuration <value>]
[--client-token <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-identifier (строка)

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

--compute-node-group-identifier (строка)

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

--ami-id (строка)

Идентификатор Amazon Machine Image (AMI), который Amazon Web Services PCS использует для запуска экземпляров. Если не указано, Amazon Web Services PCS использует идентификатор AMI, указанный в пользовательской шаблоне запуска.

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

Список идентификаторов подсетей, где группа вычислительных узлов развертывает экземпляры. Подсети должны находиться в одной VPC, что и кластер.

(строка)

Синтаксис:

"string" "string" ...

--custom-launch-template (структура)

Шаблон запуска Amazon EC2, который Amazon Web Services PCS использует для запуска вычислительных узлов.

id -> (строка)

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

Пример: lt-xxxx

version -> (строка)

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

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

id=string,version=string

JSON-синтаксис:

{
  "id": "string",
  "version": "string"
}

--purchase-option (строка)

Указывает, как Amazon Web Services PCS покупает экземпляры EC2 от вашего имени. Amazon Web Services PCS поддерживает экземпляры On-Demand и Spot. Подробнее см. в руководстве пользователя Amazon Elastic Compute Cloud (Amazon Elastic Compute Cloud User Guide) в разделе «Варианты покупки экземпляров». Если этот параметр не указан, по умолчанию используется On-Demand.

Возможные значения:

  • ONDEMAND
  • SPOT

--spot-options (структура)

Дополнительная конфигурация при указании SPOT как purchaseOption для действия API CreateComputeNodeGroup.

allocationStrategy -> (строка)

Стратегия распределения Amazon EC2, которую Amazon Web Services PCS использует для развертывания экземпляров EC2. Amazon Web Services PCS поддерживает самую низкую цену, оптимизированную по емкости и оптимизированную по цене и емкости. Подробнее см. в руководстве пользователя Amazon Elastic Compute Cloud (Amazon Elastic Compute Cloud User Guide) в разделе «Использование стратегий распределения для определения, как EC2 Fleet или Spot Fleet удовлетворяют спрос и емкость On-Demand». Если этот параметр не указан, по умолчанию используется оптимизированная по цене и емкости.

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

allocationStrategy=string

JSON-синтаксис:

{
  "allocationStrategy": "lowest-price"|"capacity-optimized"|"price-capacity-optimized"
}

--scaling-configuration (структура)

Указывает границы автоматического масштабирования группы вычислительных узлов.

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

Нижняя граница количества экземпляров, разрешенных в вычислительном флоте.

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

Верхняя граница количества экземпляров, разрешенных в вычислительном флоте.

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

minInstanceCount=integer,maxInstanceCount=integer

JSON-синтаксис:

{
  "minInstanceCount": integer,
  "maxInstanceCount": integer
}

--iam-instance-profile-arn (строка)

Amazon Resource Name (ARN) профиля IAM-профиля, используемого для передачи роли IAM при запуске экземпляров EC2. Роль, содержащаяся в вашем профиле экземпляра, должна иметь разрешение pcs:RegisterComputeNodeGroupInstance. Идентификатор ресурса ARN должен начинаться с AWSPCS или содержать /aws-pcs/ в своем пути.

Примеры
  • arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
  • arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2

--slurm-configuration (структура)

Дополнительные параметры, связанные с планировщиком Slurm.

slurmCustomSettings -> (список)

Дополнительная конфигурация, специфичная для Slurm, которая напрямую отображается в настройках Slurm.

(структура)

Дополнительные настройки, которые напрямую отображаются в настройках Slurm.

parameterName -> (строка)

Amazon Web Services PCS поддерживает конфигурацию следующих параметров Slurm:

  • Для кластеров
    • `Prolog https://slurm.schedmd.com/slurm.conf.html#OPT_Prolog_1`__
    • `Epilog https://slurm.schedmd.com/slurm.conf.html#OPT_Epilog_1`__
    • `SelectTypeParameters https://slurm.schedmd.com/slurm.conf.html#OPT_SelectTypeParameters`__
  • Для групп вычислительных узлов
    • `Weight https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__
    • `RealMemory https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__

parameterValue -> (строка)

Значения настроенных параметров Slurm.

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

slurmCustomSettings=[{parameterName=string,parameterValue=string},{parameterName=string,parameterValue=string}]

JSON-синтаксис:

{
  "slurmCustomSettings": [
    {
      "parameterName": "string",
      "parameterValue": "string"
    }
    ...
  ]
}

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Идемпотентность гарантирует, что запрос API выполняется только один раз. При идемпотентном запросе, если исходный запрос выполняется успешно, последующие повторные попытки с тем же маркером клиента возвращают результат из исходного успешного запроса, и они не оказывают дополнительного влияния. Если вы не указываете маркер клиента, CLI и SDK автоматически генерируют для вас 1.

--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
  • text
  • таблица
  • 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 версии 1, и двоичные значения должны передаваться дословно. При предоставлении содержимого из файла, соответствующего двоичному блоку, 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.

Вывод

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

Группа вычислительных узлов, связанная с кластером.

name -> (строка)

Имя, идентифицирующее группу вычислительных узлов.

id -> (строка)

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

arn -> (строка)

Уникальное Amazon Resource Name (ARN) группы вычислительных узлов.

clusterId -> (строка)

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

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

Дата и время создания ресурса.

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

Дата и время изменения ресурса.

status -> (строка)

Статус подготовки группы вычислительных узлов.

Примечание

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

amiId -> (строка)

Идентификатор Amazon Machine Image (AMI), который Amazon Web Services PCS использует для запуска экземпляров. Если не указано, Amazon Web Services PCS использует идентификатор AMI, указанный в пользовательской шаблоне запуска.

subnetIds -> (список)

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

(строка)

purchaseOption -> (строка)

Определяет, как EC2-экземпляры приобретаются от вашего имени. Amazon Web Services PCS поддерживает экземпляры On-Demand и Spot. Дополнительную информацию см. в руководстве пользователя Amazon Elastic Compute Cloud в разделе «Варианты приобретения экземпляров». Если этот параметр не указан, он по умолчанию устанавливается в On-Demand.

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

Шаблон запуска Amazon EC2, который Amazon Web Services PCS использует для запуска вычислительных узлов.

id -> (строка)

Идентификатор шаблона запуска EC2 для подготовки экземпляров.

Пример: lt-xxxx

version -> (строка)

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

iamInstanceProfileArn -> (строка)

Amazon Resource Name (ARN) профиля экземпляра IAM, используемого для передачи роли IAM при запуске EC2-экземпляров. Роль, содержащаяся в вашем профиле экземпляра, должна иметь разрешение pcs:RegisterComputeNodeGroupInstance. Идентификатор ресурса в ARN должен начинаться с AWSPCS или содержать /aws-pcs/ в своем пути.

Примеры
  • arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
  • arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2

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

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

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

Нижняя граница количества экземпляров, разрешенных в вычислительном флоте.

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

Верхняя граница количества экземпляров, разрешенных в вычислительном флоте.

instanceConfigs -> (список)

Список конфигураций EC2-экземпляров, которые Amazon Web Services PCS может подготовить в группе вычислительных узлов.

(структура)

Конфигурация EC2-экземпляра, которую Amazon Web Services PCS использует для запуска вычислительных узлов.

instanceType -> (строка)

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

Пример: t2.xlarge

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

Дополнительная конфигурация, когда вы указываете SPOT в качестве purchaseOption для действия API CreateComputeNodeGroup.

allocationStrategy -> (строка)

Стратегия выделения Amazon EC2, которую Amazon Web Services PCS использует для подготовки EC2-экземпляров. Amazon Web Services PCS поддерживает наименьшую стоимость , оптимизированную по емкости и оптимизированную по стоимости и емкости. Дополнительную информацию см. в руководстве пользователя Amazon Elastic Compute Cloud в разделе «Использование стратегий выделения для определения того, как EC2 Fleet или Spot Fleet выполняют задачу выделения Spot и On-Demand ресурсов». Если этот параметр не указан, он по умолчанию устанавливается в оптимизированную по стоимости и емкости.

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

Дополнительные параметры, связанные с планировщиком Slurm.

slurmCustomSettings -> (список)

Дополнительная конфигурация, специфичная для Slurm, которая напрямую отображается в настройках Slurm.

(структура)

Дополнительные параметры, которые напрямую отображаются в настройках Slurm.

parameterName -> (строка)

Amazon Web Services PCS поддерживает конфигурирование следующих параметров Slurm:

  • Для кластеров
    • `Prolog https://slurm.schedmd.com/slurm.conf.html#OPT_Prolog_1`__
    • `Epilog https://slurm.schedmd.com/slurm.conf.html#OPT_Epilog_1`__
    • `SelectTypeParameters https://slurm.schedmd.com/slurm.conf.html#OPT_SelectTypeParameters`__
  • Для групп вычислительных узлов
    • `Weight https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__
    • `RealMemory https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__

parameterValue -> (строка)

Значения для настроенных параметров Slurm.

errorInfo -> (список)

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

(структура)

Ошибка, возникшая во время создания ресурса.

code -> (строка)

Код ошибки в сокращенном формате.

message -> (строка)

Подробная информация об ошибке.

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

Spec-Zone.ru

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