обновить-среду-вычислений

Описание

Обновляет среду вычислений Batch.

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

Синтаксис

  update-compute-environment
--compute-environment <value>
[--state <value>]
[--unmanagedv-cpus <value>]
[--compute-resources <value>]
[--service-role <value>]
[--update-policy <value>]
[--context <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]

Параметры

--compute-environment (строка)

Имя или полный Amazon Resource Name (ARN) среды вычислений, которую необходимо обновить.

--state (строка)

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

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

Если состояние равно DISABLED, диспетчер Batch не пытается поместить задания в среду. Задания в состоянии STARTING или RUNNING продолжают выполняться нормально. Управляемые среды вычислений в состоянии DISABLED не масштабируются.

Примечание

Среды вычислений в состоянии DISABLED могут по-прежнему взимать плату. Чтобы предотвратить дополнительные платежи, выключите и удалите среду вычислений. Дополнительную информацию см. в разделе «Состояние» в Руководстве пользователя Batch.

Когда экземпляр бездействует, он масштабируется до значения minvCpus. Однако размер экземпляра не меняется. Например, рассмотрите экземпляр c5.8xlarge со значением minvCpus равным 4 и значением desiredvCpus равным 36. Этот экземпляр не масштабируется до экземпляра c5.large.

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

ENABLED
DISABLED

--unmanagedv-cpus (целое число)

Максимальное количество виртуальных процессоров (vCPU), ожидаемых для использования в неуправляемой среде вычислений. Не указывайте этот параметр для управляемой среды вычислений. Этот параметр используется только для планирования с долей ресурсов, чтобы зарезервировать емкость vCPU для новых идентификаторов долей. Если этот параметр не указан для очереди заданий с долями ресурсов, емкость vCPU не резервируется.

--compute-resources (структура)

Подробности о вычислительных ресурсах, управляемых вычислительной средой. Требуется для управляемой вычислительной среды. Дополнительную информацию см. в разделе «Вычислительные среды» в Руководстве пользователя Batch.

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

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

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

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

Максимальное количество виртуальных процессоров Amazon EC2 vCPU, которое может достичь среда.

Примечание

С BEST_FIT_PROGRESSIVE, стратегиями ``SPOT_CAPACITY_OPTIMIZED`` и SPOT_PRICE_CAPACITY_OPTIMIZED (рекомендуемая) с использованием экземпляров по требованию или резервируемых экземпляров, и стратегией BEST_FIT с использованием резервируемых экземпляров, Batch может потребоваться превысить maxvCpus, чтобы удовлетворить вашим потребностям в вычислительной мощности. В этом случае Batch никогда не превышает maxvCpus более чем на один экземпляр.

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

Желаемое количество виртуальных процессоров (vCPU) в вычислительной среде. Batch изменяет это значение между минимальным и максимальным значениями в зависимости от спроса в очереди задач.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

Примечание

Batch не поддерживает изменение желаемого количества vCPU существующей вычислительной среды. Не указывайте этот параметр для вычислительных сред, использующих кластеры Amazon EKS.

Примечание

При обновлении параметра desiredvCpus, его значение должно находиться в диапазоне между minvCpus и maxvCpus.

Кроме того, обновленное значение desiredvCpus должно быть больше или равно текущему значению desiredvCpus. Дополнительную информацию см. в разделе Устранение неполадок Batch в Руководстве пользователя Batch.

subnets -> (список)

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

При обновлении вычислительной среды изменение подсетей VPC требует обновления инфраструктуры вычислительной среды. Дополнительную информацию см. в разделе Обновление вычислительных сред в Руководстве пользователя Batch.

Примечание

Batch в Amazon EC2 и Batch в Amazon EKS поддерживают локальные зоны. Дополнительную информацию см. в разделе Локальные зоны в Руководстве пользователя Amazon EC2 для Linux-инстансов, Amazon EKS и локальные зоны Amazon Web Services в Руководстве пользователя Amazon EKS и кластеры Amazon ECS в локальных зонах, зонах Wavelength и Amazon Web Services Outposts в Руководстве разработчика Amazon ECS.

Batch на Fargate в настоящее время не поддерживает локальные зоны.

(строка)

securityGroupIds -> (список)

Группы безопасности Amazon EC2, которые связаны с экземплярами, запущенными в вычислительной среде. Этот параметр обязателен для вычислительных ресурсов Fargate, где он может содержать до 5 групп безопасности. Для вычислительных ресурсов Fargate предоставление пустого списка обрабатывается так, как если бы этот параметр не был указан, и никаких изменений не было внесено. Для вычислительных ресурсов Amazon EC2 предоставление пустого списка удаляет группы безопасности из вычислительного ресурса.

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

(строка)

allocationStrategy -> (строка)

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

При обновлении вычислительной среды изменение стратегии распределения требует обновления инфраструктуры вычислительной среды. Дополнительную информацию см. в разделе Обновление вычислительных сред в руководстве пользователя Batch . BEST_FIT не поддерживается при обновлении вычислительной среды.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

BEST_FIT_PROGRESSIVE

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

SPOT_CAPACITY_OPTIMIZED

Batch выбирает один или несколько типов экземпляров, достаточно мощных для удовлетворения требований задач в очереди. Его предпочтение отдаётся типам экземпляров, которые менее подвержены прерыванию. Эта стратегия распределения доступна только для вычислительных ресурсов Spot Instance.

SPOT_PRICE_CAPACITY_OPTIMIZED

Стратегия распределения, оптимизированная по цене и ресурсам, учитывает как цену, так и ёмкость, чтобы выбрать пулы Spot Instance, которые менее подвержены прерыванию и имеют наименьшую возможную цену. Эта стратегия распределения доступна только для вычислительных ресурсов Spot Instance.

При использовании стратегий ``SPOT_CAPACITY_OPTIMIZED`` и SPOT_PRICE_CAPACITY_OPTIMIZED (рекомендуется) с использованием экземпляров On-Demand или Spot, и стратегии BEST_FIT с использованием экземпляров Spot, Batch может потребоваться превысить maxvCpus, чтобы удовлетворить ваши потребности в ресурсах. В этом случае Batch никогда не превышает maxvCpus более чем на один экземпляр.

instanceTypes -> (list)

Типы экземпляров, которые можно запустить. Вы можете указать семейства экземпляров для запуска любого типа экземпляра в этих семействах (например, c5 или p3 ), или вы можете указать конкретные размеры в рамках семейства (например, c5.8xlarge ). Вы также можете выбрать optimal для выбора типов экземпляров (из семейств экземпляров C4, M4 и R4), которые соответствуют требованиям ваших очередей задач.

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

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

Примечание

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

Примечание

В настоящее время optimal использует типы экземпляров из семейств C4, M4 и R4. В регионах, в которых нет типов экземпляров из этих семейств, используются типы экземпляров из семейств C5, M5 и R5.

(string)

ec2KeyPair -> (string)

Пара EC2-ключа, используемая для экземпляров, запущенных в вычислительной среде. Вы можете использовать этот ключ для входа в ваши экземпляры с помощью SSH. Для удаления пары EC2-ключей установите это значение в пустую строку.

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

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

instanceRole -> (string)

Профиль экземпляра Amazon ECS, применяемый к экземплярам Amazon EC2 в вычислительной среде. Необходим для экземпляров Amazon EC2. Вы можете указать короткое имя или полное Amazon Resource Name (ARN) профиля экземпляра. Например, `` ecsInstanceRole `` или ``arn:aws:iam::<aws_account_id> :instance-profile/ecsInstanceRole `` . Дополнительную информацию см. в разделе Amazon ECS instance role в руководстве пользователя Batch .

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

tags -> (map)

Теги пары «ключ-значение», которые применяются к ресурсам Amazon EC2, запущенным в среде выполнения. Для Batch эти теги имеют вид "String1": "String2", где String1 — ключ тега, а String2 — значение тега (например, { "Name": "Batch Instance - C4OnDemand" }). Это помогает распознать ваши экземпляры Batch в консоли Amazon EC2. Эти теги не отображаются при использовании операции API Batch ListTagsForResource.

При обновлении среды выполнения изменение этого параметра требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

key -> (строка)

value -> (строка)

placementGroup -> (строка)

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

При обновлении среды выполнения изменение группы размещения требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

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

Максимальный процент, на который цена Spot-экземпляра может превышать цену On-Demand для данного типа экземпляра перед запуском экземпляров. Например, если ваш максимальный процент составляет 20%, цена Spot должна быть меньше 20% текущей цены On-Demand для данного экземпляра Amazon EC2. Вы всегда платите самую низкую (рыночную) цену и никогда не больше, чем ваш максимальный процент. Для большинства случаев рекомендуется оставить это поле пустым.

При обновлении среды выполнения изменение процента ставки требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

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

Обновлённая шаблон запуска, который нужно использовать для ваших вычислительных ресурсов. В запросе необходимо указать либо ID шаблона запуска, либо имя шаблона запуска, но не оба значения. Дополнительную информацию см. в разделе Поддержка шаблонов запуска в руководстве пользователя Batch. Чтобы удалить пользовательский шаблон запуска и использовать шаблон запуска по умолчанию, установите член launchTemplateId или launchTemplateName спецификации шаблона запуска в пустую строку. Удаление шаблона запуска из среды выполнения не удалит AMI, указанный в шаблоне запуска. Для обновления AMI, указанного в шаблоне запуска, параметр updateToLatestImageVersion должен быть установлен в true.

При обновлении среды выполнения изменение шаблона запуска требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

launchTemplateId -> (строка)

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

launchTemplateName -> (строка)

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

version -> (строка)

Номер версии шаблона запуска, $Default или $Latest.

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

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

Если ID AMI, используемый в среде выполнения, взято из шаблона запуска, AMI не изменяется при обновлении среды выполнения. Он меняется только если параметр updateToLatestImageVersion для среды выполнения установлен в true. Во время обновления инфраструктуры, если указаны либо $Default, либо $Latest, Batch повторно оценивает версию шаблона запуска и может использовать другую версию шаблона запуска. Это происходит даже если шаблон запуска не указан в обновлении. При обновлении среды выполнения изменение шаблона запуска требует обновления инфраструктуры среды выполнения. Дополнительную информацию см. в разделе Обновление сред выполнения в руководстве пользователя Batch.

По умолчанию: $Default

Последняя: $Latest

overrides -> (список)

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

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

Примечание

Чтобы сбросить все наложения шаблонов для вычислительного окружения, можно передать пустой массив в параметр UpdateComputeEnvironment.overrides или не включать параметр overrides при отправке операции API UpdateComputeEnvironment.

(структура)

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

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

Вы можете определить до десяти (10) наложений для каждого вычислительного окружения.

Примечание

Этот объект не применим к задачам, выполняемым на ресурсах Fargate.

Примечание

launchTemplateId -> (строка)

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

Примечание: Если вы указываете launchTemplateId, вы не можете указать launchTemplateName.

launchTemplateName -> (строка)

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

Примечание: Если вы указываете launchTemplateName, вы не можете указать launchTemplateId.

version -> (строка)

Номер версии шаблона запуска, $Default или $Latest.

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

Если идентификатор AMI, используемый в вычислительном окружении, взят из шаблона запуска, AMI не изменяется при обновлении вычислительного окружения. Он изменяется только в том случае, если параметр updateToLatestImageVersion для вычислительного окружения установлен в значение true. Во время обновления инфраструктуры, если указан либо $Default, либо $Latest, Batch повторно оценивает версию шаблона запуска и может использовать другую версию шаблона запуска. Это имеет место даже в том случае, если шаблон запуска не указан в обновлении. При обновлении вычислительного окружения изменение шаблона запуска требует обновления инфраструктуры вычислительного окружения. Для получения дополнительной информации см. Обновление вычислительных сред в руководстве пользователя Batch.

По умолчанию: $Default

Последняя: $Latest

targetInstanceTypes -> (список)

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

Этот параметр необходим при определении наложения шаблона запуска.

Информация, включенная в этот параметр, должна соответствовать следующим требованиям:

Должен быть допустимым типом или семейством экземпляров Amazon EC2.
optimal не допускается.
targetInstanceTypes может ориентироваться только на типы и семейства экземпляров, включенные в ` ComputeResource.instanceTypes https://docs.aws.amazon.com/batch/latest/APIReference/API_ComputeResource.html#Batch-Type-ComputeResource-instanceTypes`__ набор. targetInstanceTypes не обязательно должен включать все экземпляры из instanceType набора, но по крайней мере подмножество. Например, если ComputeResource.instanceTypes включает [m5, g5], targetInstanceTypes может включать [m5.2xlarge] и [m5.large], но не [c5.large].
targetInstanceTypes, включенные в рамках одного наложения шаблона запуска или нескольких наложений шаблонов запуска для одного вычислительного окружения, не должны перекрываться. Например, вы не можете определить одно наложение шаблона запуска для целевого семейства экземпляров и другое для целевого типа экземпляра в этом же семействе.

(строка)

ec2Configuration -> (список)

Предоставляет информацию, используемую для выбора Amazon Machine Images (AMI) для экземпляров Amazon EC2 в вычислительной среде. Если Ec2Configuration не указано, используется значение по умолчанию ECS_AL2.

При обновлении вычислительной среды изменение этого параметра требует обновления инфраструктуры вычислительной среды. Дополнительную информацию см. в руководстве пользователя Batch, раздел Обновление вычислительных сред. Чтобы удалить конфигурацию Amazon EC2 и любой пользовательский идентификатор AMI, указанный в imageIdOverride, установите это значение в пустую строку.

Можно указать одно или два значения.

Примечание

Этот параметр не применим к задачам, выполняющимся на ресурсах Fargate. Не указывайте его.

(структура)

Предоставляет информацию для выбора Amazon Machine Images (AMI) для экземпляров в вычислительной среде. Если Ec2Configuration не указано, по умолчанию используется значение ECS_AL2 (Amazon Linux 2).

Примечание

Этот объект не применим к задачам, выполняющимся на ресурсах Fargate.

imageType -> (строка)

Тип образа, который сопоставляется с типом экземпляра для выбора AMI. Доступные значения отличаются для ресурсов ECS и EKS.

ECS

Если параметр imageIdOverride не указан, используется недавний оптимизированный для Amazon ECS образ Amazon Linux 2 (ECS_AL2). Если при обновлении указан новый тип образа, но не указаны параметры imageId и imageIdOverride, используется последняя оптимизированная для Amazon ECS AMI для этого типа образа, поддерживаемая Batch.

ECS_AL2

Amazon Linux 2: Значение по умолчанию для всех семейств экземпляров без графических процессоров.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU): Значение по умолчанию для всех семейств экземпляров с графическими процессорами (например, P4 и G4) и может использоваться для всех типов экземпляров без поддержки Amazon Web Services Graviton.

ECS_AL2023

Amazon Linux 2023: Batch поддерживает Amazon Linux 2023.

Примечание

Amazon Linux 2023 не поддерживает A1 экземпляры.

ECS_AL1

Amazon Linux. Amazon Linux достиг конца срока поддержки стандартной поддержки. Дополнительную информацию см. в документации Amazon Linux AMI.

EKS

Если параметр imageIdOverride не указан, используется недавний оптимизированный для Amazon EKS образ Amazon Linux AMI (EKS_AL2). Если при обновлении указан новый тип образа, но не указаны параметры imageId и imageIdOverride, используется последняя оптимизированная для Amazon EKS AMI для этого типа образа, поддерживаемая Batch.

EKS_AL2

Amazon Linux 2: Значение по умолчанию для всех семейств экземпляров без графических процессоров.

EKS_AL2_NVIDIA

Amazon Linux 2 (ускоренный): Значение по умолчанию для всех семейств экземпляров с графическими процессорами (например, P4 и G4) и может использоваться для всех типов экземпляров без поддержки Amazon Web Services Graviton.

imageIdOverride -> (строка)

Идентификатор AMI, используемый для экземпляров, запущенных в вычислительной среде, соответствующих типу образа. Это значение переопределяет значение imageId, заданное в объекте computeResource.

Примечание

AMI, выбранный для вычислительной среды, должен соответствовать архитектуре типов экземпляров, которые вы намерены использовать для этой вычислительной среды. Например, если ваша вычислительная среда использует типы экземпляров A1, AMI вычислительного ресурса, который вы выбираете, должен поддерживать ARM экземпляры. Amazon ECS предоставляет как x86, так и ARM версии оптимизированного для Amazon ECS образа Amazon Linux 2 AMI. Дополнительную информацию см. в руководстве разработчика Amazon Elastic Container Service, раздел Amazon ECS-оптимизированный Amazon Linux 2 AMI.

imageKubernetesVersion -> (строка)

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

updateToLatestImageVersion -> (булево)

Указывает, обновляется ли идентификатор AMI до последней поддерживаемой Batch версии при обновлении инфраструктуры вычислительной среды. Значение по умолчанию — false.

Примечание

Идентификатор AMI можно указать в параметрах imageId или imageIdOverride или определить из шаблона запуска, указанного в параметре launchTemplate. Если идентификатор AMI указан любым из этих способов, этот параметр игнорируется. Дополнительную информацию об обновлении идентификаторов AMI во время обновления инфраструктуры см. в руководстве пользователя Batch, раздел Обновление идентификатора AMI.

type -> (строка)

Тип вычислительной среды: EC2 , SPOT , FARGATE или FARGATE_SPOT . Дополнительную информацию см. в руководстве пользователя Batch.

Если вы выберите SPOT , вы также должны указать роль Amazon EC2 Spot Fleet с параметром spotIamFleetRole . Дополнительную информацию см. в руководстве пользователя Batch по ролям Amazon EC2 spot fleet.

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

imageId -> (строка)

Идентификатор Amazon Machine Image (AMI), используемый для запуска экземпляров в вычислительной среде. Этот параметр переопределяется членом imageIdOverride структуры Ec2Configuration . Чтобы удалить пользовательский идентификатор AMI и использовать идентификатор AMI по умолчанию, установите это значение в пустую строку.

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

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах Fargate. Не указывайте его.

Примечание

AMI, который вы выбираете для вычислительной среды, должен соответствовать архитектуре типов экземпляров, которые вы планируете использовать для этой вычислительной среды. Например, если ваша вычислительная среда использует типы экземпляров A1, AMI вычислительного ресурса, который вы выбираете, должен поддерживать ARM-экземпляры. Amazon ECS предоставляет x86 и ARM версии оптимизированного AMI Amazon Linux 2 для Amazon ECS. Дополнительную информацию см. в руководстве разработчика Amazon Elastic Container Service по AMI Amazon Linux 2, оптимизированному для Amazon ECS.

Синтаксис JSON:

{
  "minvCpus": integer,
  "maxvCpus": integer,
  "desiredvCpus": integer,
  "subnets": ["string", ...],
  "securityGroupIds": ["string", ...],
  "allocationStrategy": "BEST_FIT_PROGRESSIVE"|"SPOT_CAPACITY_OPTIMIZED"|"SPOT_PRICE_CAPACITY_OPTIMIZED",
  "instanceTypes": ["string", ...],
  "ec2KeyPair": "string",
  "instanceRole": "string",
  "tags": {"string": "string"
    ...},
  "placementGroup": "string",
  "bidPercentage": integer,
  "launchTemplate": {
    "launchTemplateId": "string",
    "launchTemplateName": "string",
    "version": "string",
    "overrides": [
      {
        "launchTemplateId": "string",
        "launchTemplateName": "string",
        "version": "string",
        "targetInstanceTypes": ["string", ...]
      }
      ...
    ]
  },
  "ec2Configuration": [
    {
      "imageType": "string",
      "imageIdOverride": "string",
      "imageKubernetesVersion": "string"
    }
    ...
  ],
  "updateToLatestImageVersion": true|false,
  "type": "EC2"|"SPOT"|"FARGATE"|"FARGATE_SPOT",
  "imageId": "string"
}

--service-role (строка)

Полный Amazon Resource Name (ARN) роли IAM, позволяющей Batch делать вызовы к другим службам Amazon Web Services от вашего имени. Дополнительную информацию см. в руководстве пользователя Batch по ролям IAM служб Batch.

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

Если вычислительная среда имеет роль служб, ее нельзя изменить на использование обычной роли IAM. Аналогично, если вычислительная среда имеет обычную роль IAM, ее нельзя изменить на использование роли служб. Чтобы обновить параметры вычислительной среды, которые требуют обновления инфраструктуры, необходимо использовать роль служб AWSServiceRoleForBatch. Дополнительную информацию см. в руководстве пользователя Batch по обновлению вычислительных сред.

Если указанная роль имеет путь, отличный от / , необходимо либо указать полный ARN роли (рекомендуется), либо добавить имя роли с указанием пути.

Примечание

В зависимости от того, как вы создали роль службы Batch, ее ARN может содержать префикс пути service-role . Когда вы указываете только имя роли службы, Batch предполагает, что ваш ARN не использует префикс пути service-role . По этой причине рекомендуется указывать полный ARN вашей роли служб при создании вычислительных сред.

--update-policy (структура)

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

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

Указывает, будут ли задачи автоматически завершаться при обновлении инфраструктуры вычислительной среды. Значение по умолчанию — false .

jobExecutionTimeoutMinutes -> (длинное целое число)

Указывает время ожидания задачи (в минутах) при обновлении инфраструктуры вычислительной среды. Значение по умолчанию — 30.

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

terminateJobsOnUpdate=boolean,jobExecutionTimeoutMinutes=long

Синтаксис JSON:

{
  "terminateJobsOnUpdate": true|false,
  "jobExecutionTimeoutMinutes": long
}

--context (строка)

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

--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 (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 для вывода.

--cli-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Обновление среды выполнения

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

Команда:

aws batch update-compute-environment --compute-environment P2OnDemand --state DISABLED

Вывод:

{
    "computeEnvironmentName": "P2OnDemand",
    "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand"
}

Вывод

computeEnvironmentName -> (string)

Имя среды выполнения. Длина может составлять до 128 символов. Может содержать заглавные и строчные буквы, цифры, дефисы (-) и символы подчеркивания (_).

computeEnvironmentArn -> (string)

Amazon Resource Name (ARN) среды выполнения.