describe-compute-environments

Описание

Описывает один или несколько ваших вычислительных сред.

Если вы используете неуправляемую вычислительную среду, вы можете использовать операцию DescribeComputeEnvironment для определения ecsClusterArn, в которую вы запускаете свои контейнерные экземпляры Amazon ECS.

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

describe-compute-environments является постраничной операцией. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной загрузкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: computeEnvironments

Синтаксис

  describe-compute-environments
[--compute-environments <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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-environments (список)

Список из до 100 имен вычислительных сред или полных записей Amazon Resource Name (ARN).

(строка)

Синтаксис:

"string" "string" ...

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные через JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного через JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

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

Токен для указания места начала постраничной загрузки. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничная загрузка в руководстве пользователя AWS CLI.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймауты вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная загрузка в руководстве пользователя AWS CLI.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше, чем указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной загрузки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная загрузка в руководстве пользователя AWS CLI.

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Для описания вычислительной среды

В этом примере описывается вычислительная среда P2OnDemand.

Команда:

aws batch describe-compute-environments --compute-environments P2OnDemand

Вывод:

{
    "computeEnvironments": [
        {
            "status": "VALID",
            "serviceRole": "arn:aws:iam::012345678910:role/AWSBatchServiceRole",
            "computeEnvironmentArn": "arn:aws:batch:us-east-1:012345678910:compute-environment/P2OnDemand",
            "computeResources": {
                "subnets": [
                    "subnet-220c0e0a",
                    "subnet-1a95556d",
                    "subnet-978f6dce"
                ],
                "tags": {
                    "Name": "Batch Instance - P2OnDemand"
                },
                "desiredvCpus": 48,
                "minvCpus": 0,
                "instanceTypes": [
                    "p2"
                ],
                "securityGroupIds": [
                    "sg-cf5093b2"
                ],
                "instanceRole": "ecsInstanceRole",
                "maxvCpus": 128,
                "type": "EC2",
                "ec2KeyPair": "id_rsa"
            },
            "statusReason": "ComputeEnvironment Healthy",
            "ecsClusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/P2OnDemand_Batch_2c06f29d-d1fe-3a49-879d-42394c86effc",
            "state": "ENABLED",
            "computeEnvironmentName": "P2OnDemand",
            "type": "MANAGED"
        }
    ]
}

Вывод

computeEnvironments -> (список)

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

(структура)

Объект, представляющий вычислительную среду Batch.

computeEnvironmentName -> (строка)

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

computeEnvironmentArn -> (строка)

Amazon Resource Name (ARN) вычислительной среды.

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

Максимальное количество VCPU, ожидаемых для использования в неуправляемой вычислительной среде.

ecsClusterArn -> (строка)

Amazon Resource Name (ARN) базового кластера Amazon ECS, используемого вычислительной средой.

tags -> (карта)

Теги, применённые к вычислительной среде.

key -> (строка)

value -> (строка)

type -> (строка)

Тип вычислительной среды: MANAGED или UNMANAGED. Подробнее см. Вычислительные среды в руководстве пользователя Batch.

state -> (строка)

Состояние вычислительной среды. Допустимые значения — ENABLED или DISABLED.

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

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

Примечание

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

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

status -> (строка)

Текущее состояние вычислительной среды (например, CREATING или VALID).

statusReason -> (строка)

Короткая, понятная строка для предоставления дополнительной информации о текущем состоянии вычислительной среды.

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

Вычисляемые ресурсы, определённые для вычислительной среды. Для получения дополнительной информации см. Вычислительные среды в Руководстве пользователя Batch.

type -> (строка)

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

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

allocationStrategy -> (строка)

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

Примечание

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

BEST_FIT (по умолчанию)

Batch выбирает тип экземпляра, который наилучшим образом подходит для задач, отдавая предпочтение экземплярам с самой низкой стоимостью. Если дополнительные экземпляры выбранного типа экземпляра недоступны, Batch ожидает их появления. Если экземпляров недостаточно или пользователь достигает пределов сервиса Amazon EC2, дополнительные задачи не запускаются до завершения текущих. Эта стратегия распределения поддерживает низкие затраты, но может ограничивать масштабирование. Если вы используете Spot Fleet с BEST_FIT, должна быть указана роль IAM Spot Fleet. Вычислительные ресурсы, использующие стратегию распределения BEST_FIT, не поддерживают обновления инфраструктуры и не могут обновлять некоторые параметры. Для получения дополнительной информации см. Обновление вычислительных сред в Руководстве пользователя Batch.

BEST_FIT_PROGRESSIVE

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

SPOT_CAPACITY_OPTIMIZED

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

SPOT_PRICE_CAPACITY_OPTIMIZED

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

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

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

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

Примечание

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

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

Максимальное количество vCPU, которое может поддерживать вычислительная среда.

Примечание

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

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

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

Примечание

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

instanceTypes -> (список)

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

Примечание

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

Примечание

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

Примечание

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

(строка)

imageId -> (строка)

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

Примечание

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

Примечание

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

subnets -> (список)

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

Примечание

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, связанные с экземплярами, запущенными в вычислительной среде. Необходимо указать одну или несколько групп безопасности, либо в securityGroupIds, либо используя шаблон запуска, указанный в launchTemplate. Этот параметр обязателен для задач, выполняемых на ресурсах Fargate, и должен содержать по крайней мере одну группу безопасности. Fargate не поддерживает шаблоны запуска. Если группы безопасности указаны с помощью securityGroupIds и launchTemplate, используются значения в securityGroupIds.

(строка)

ec2KeyPair -> (строка)

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

Примечание

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

instanceRole -> (строка)

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

Примечание

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

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

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

Примечание

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

key -> (строка)

value -> (строка)

placementGroup -> (строка)

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

Примечание

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

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

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

Примечание

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

spotIamFleetRole -> (строка)

Идентификатор ресурса Amazon (ARN) роли IAM Amazon EC2 Spot Fleet, применяемой к среде вычислений. Эта роль требуется, если стратегия распределения задана как BEST_FIT или если стратегия распределения не указана. Дополнительную информацию см. в разделе Роль Amazon EC2 Spot Fleet в руководстве пользователя Batch .

Примечание

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

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

Для добавления тегов к вашим экземплярам Spot при создании роль IAM Spot Fleet, указанная здесь, должна использовать новую управляемую политику AmazonEC2SpotFleetTaggingRole. Предыдущая рекомендуемая управляемая политика AmazonEC2SpotFleetRole не имеет необходимых разрешений для добавления тегов к экземплярам Spot. Дополнительную информацию см. в разделе Экземпляры Spot не помечены при создании в руководстве пользователя Batch .

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

Шаблон запуска, используемый для ваших вычислительных ресурсов. Любые другие параметры вычислительных ресурсов, которые вы указываете в операции API CreateComputeEnvironment, перезаписывают те же параметры в шаблоне запуска. Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска в запросе, но не оба. Дополнительную информацию см. в разделе Поддержка шаблонов запуска в руководстве пользователя Batch .

Примечание

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

launchTemplateId -> (строка)

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

launchTemplateName -> (строка)

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

version -> (строка)

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

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

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

Если идентификатор 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.

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

По умолчанию: $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.

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

Примечание

Этот параметр не применим к задачам, выполняемым на ресурсах 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 (с графическим процессором): значение по умолчанию для всех семейств экземпляров с графическими процессорами (например, 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 Linux AMI, оптимизированный для Amazon EKS (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. Дополнительную информацию см. в разделе Оптимизированный для Amazon ECS образ Amazon Linux 2 в руководстве разработчика Amazon Elastic Container Service.

imageKubernetesVersion -> (строка)

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

serviceRole -> (строка)

Роль службы, связанная с вычислительной средой, которая позволяет Batch выполнять операции с API Amazon Web Services от вашего имени. Дополнительную информацию см. в разделе Роль IAM службы Batch в руководстве пользователя Batch.

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

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

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

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

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

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

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

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

eksClusterArn -> (строка)

Идентификатор ресурса Amazon (ARN) кластера Amazon EKS. Пример: ``arn:aws :eks:us-east-1 :123456789012 :cluster/ClusterForBatch ``.

kubernetesNamespace -> (строка)

Пространство имен кластера Amazon EKS. Batch управляет поддосами в этом пространстве имен. Значение не может быть пустым или нулевым. Оно должно быть короче 64 символов, не должно быть равно default, не должно начинаться с “kube-”, и должно соответствовать следующему регулярному выражению: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. Дополнительную информацию см. в документации Kubernetes в разделе Пространства имен.

containerOrchestrationType -> (строка)

Тип оркестрации вычислительной среды. Допустимые значения — ECS (по умолчанию) или EKS.

uuid -> (строка)

Уникальный идентификатор вычислительной среды.

context -> (строка)

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

nextToken -> (строка)

Значение nextToken, которое следует включить в будущий запрос DescribeComputeEnvironments. Если результаты запроса DescribeComputeEnvironments превышают maxResults, это значение можно использовать для получения следующей страницы результатов. Это значение равно null, если больше результатов нет.