stop-task

Описание

Останавливает запущенную задачу. Все теги, связанные с задачей, будут удалены.

При вызове StopTask для задачи, контейнерам, работающим в задаче, отправляется эквивалент docker stop. Это приводит к значению SIGTERM и стандартному таймауту 30 секунд, после чего отправляется значение SIGKILL, и контейнеры останавливаются насильственно. Если контейнер обрабатывает значение SIGTERM корректно и завершается в течение 30 секунд после его получения, значение SIGKILL не отправляется.

Для контейнеров Windows POSIX-сигналы не работают, и среда выполнения останавливает контейнер, отправив CTRL_SHUTDOWN_EVENT. Дополнительную информацию см. в разделе Unable to react to graceful shutdown of (Windows) container #25982 на GitHub.

Примечание

Стандартный таймаут в 30 секунд можно настроить в агенте Amazon ECS контейнера с помощью переменной ECS_CONTAINER_STOP_TIMEOUT. Дополнительную информацию см. в разделе Amazon ECS Container Agent Configuration в руководстве разработчика Amazon Elastic Container Service.

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

Синтаксис

  stop-task
[--cluster <value>]
--task <value>
[--reason <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 (строка)

Короткое имя или полное Amazon Resource Name (ARN) кластера, который размещает задачу для остановки. Если вы не указываете кластер, используется кластер по умолчанию.

--task (строка)

Полный Amazon Resource Name (ARN) задачи.

--reason (строка)

Необязательное сообщение, указанное при остановке задачи. Например, если вы используете пользовательский планировщик, вы можете использовать этот параметр для указания причины остановки задачи, и сообщение отобразится в последующих операциях API DescribeTasks для этой задачи.

--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
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.

Примеры

Примечание

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

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

Остановка задачи

Следующий stop-task останавливает указанную задачу в кластере по умолчанию.

aws ecs stop-task \
    --task 666fdccc2e2d4b6894dd422f4eeee8f8

Вывод:

{
    "task": {
        "taskArn": "arn:aws:ecs:us-west-2:130757420319:task/default/666fdccc2e2d4b6894dd422f4eeee8f8",
        "clusterArn": "arn:aws:ecs:us-west-2:130757420319:cluster/default",
        "taskDefinitionArn": "arn:aws:ecs:us-west-2:130757420319:task-definition/sleep360:3",
        "containerInstanceArn": "arn:aws:ecs:us-west-2:130757420319:container-instance/default/765936fadbdd46b5991a4bd70c2a43d4",
        "overrides": {
            "containerOverrides": []
        },
        "lastStatus": "STOPPED",
        "desiredStatus": "STOPPED",
        "cpu": "128",
        "memory": "128",
        "containers": [],
        "version": 2,
        "stoppedReason": "Taskfailedtostart",
        "stopCode": "TaskFailedToStart",
        "connectivity": "CONNECTED",
        "connectivityAt": 1563421494.186,
        "pullStartedAt": 1563421494.252,
        "pullStoppedAt": 1563421496.252,
        "executionStoppedAt": 1563421497,
        "createdAt": 1563421494.186,
        "stoppingAt": 1563421497.252,
        "stoppedAt": 1563421497.252,
        "group": "family:sleep360",
        "launchType": "EC2",
        "attachments": [],
        "tags": []
    }
}

Выходные данные

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

Задача, которая была остановлена.

attachments -> (список)

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

(структура)

Объект, представляющий экземпляр контейнера или привязку задачи.

id -> (строка)

Уникальный идентификатор привязки.

type -> (строка)

Тип привязки, такой как ElasticNetworkInterface, Service Connect и AmazonElasticBlockStorage.

status -> (строка)

Состояние привязки. Допустимые значения — PRECREATED, CREATED, ATTACHING, ATTACHED, DETACHING, DETACHED, DELETED и FAILED.

details -> (список)

Детали привязки.

Для эластичных сетевых интерфейсов это включает идентификатор сетевого интерфейса, MAC-адрес, идентификатор подсети и частный IPv4-адрес.

Для служб Service Connect это включает portName, clientAliases, discoveryName и ingressPortOverride.

Для Elastic Block Storage это включает roleArn, deleteOnTermination, volumeName, volumeId и statusReason (только в случае сбоя создания или привязки привязки).

(структура)

Объект сопоставления ключ-значение.

name -> (строка)

Имя пары ключ-значение. Для переменных среды это имя переменной среды.

value -> (строка)

Значение пары ключ-значение. Для переменных среды это значение переменной среды.

attributes -> (список)

Атрибуты задачи

(структура)

Атрибут — это пара имя-значение, которая ассоциируется с объектом Amazon ECS. Используйте атрибуты для расширения модели данных Amazon ECS, добавив пользовательские метаданные к вашим ресурсам. Дополнительную информацию см. в разделе Атрибуты в руководстве разработчика Amazon Elastic Container Service.

name -> (строка)

Имя атрибута. name должно содержать от 1 до 128 символов. Имя может содержать буквы (строчные и прописные), цифры, дефисы (-), подчеркивания (_), косые черты (/), обратные косые черты (\) или точки (.).

value -> (строка)

Значение атрибута. value должно содержать от 1 до 128 символов. Оно может содержать буквы (строчные и прописные), цифры, дефисы (-), подчеркивания (_), точки (.), знаки «@», косые черты (/), обратные косые черты (\), двоеточия (:) или пробелы. Значение не может начинаться или заканчиваться пробелом.

targetType -> (строка)

Тип целевого объекта для привязки атрибута. Этот параметр требуется, если вы используете сокращенную форму идентификатора ресурса вместо полного ARN.

targetId -> (строка)

Идентификатор целевого объекта. Вы можете указать сокращенную форму идентификатора ресурса или полное имя Amazon Resource Name (ARN).

availabilityZone -> (строка)

Зона доступности задачи.

capacityProviderName -> (строка)

Провайдер емкости, связанный с задачей.

clusterArn -> (строка)

ARN кластера, в котором размещена задача.

connectivity -> (строка)

Статус подключения задачи.

connectivityAt -> (временная метка)

Временная метка Unix для времени, когда задача последний раз перешла в состояние CONNECTED.

containerInstanceArn -> (строка)

ARN экземпляров контейнеров, которые размещают задачу.

containers -> (список)

Контейнеры, связанные с задачей.

(структура)

Контейнер Docker, который является частью задачи.

containerArn -> (строка)

Amazon Resource Name (ARN) контейнера.

taskArn -> (строка)

ARN задачи.

name -> (строка)

Имя контейнера.

image -> (строка)

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

imageDigest -> (строка)

Digest образа контейнера.

runtimeId -> (строка)

Идентификатор контейнера Docker.

lastStatus -> (строка)

Последнее известное состояние контейнера.

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

Код завершения, возвращенный контейнером.

reason -> (строка)

Краткое (максимум 1024 символа) читаемое строка для предоставления дополнительных сведений о работающем или остановленном контейнере.

networkBindings -> (список)

Привязки сети, связанные с контейнером.

(структура)

Подробная информация о сетевых привязках между контейнером и его хост-экземпляром контейнера. После того как задача достигает состояния RUNNING, ручные и автоматические назначения портов хоста и контейнера отображаются в разделе networkBindings ответов API DescribeTasks.

bindIP -> (строка)

IP-адрес, к которому привязан контейнер в экземпляре контейнера.

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

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

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

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

protocol -> (строка)

Протокол, используемый для сетевой привязки.

containerPortRange -> (строка)

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

При указании containerPortRange действуют следующие правила:

Вы должны использовать режим сети bridge или режим сети awsvpc.
Этот параметр доступен для типов запуска EC2 и Fargate.
Этот параметр доступен для операционных систем Linux и Windows.
В экземпляре контейнера должна быть установлена как минимум версия 1.67.0 агента контейнера и как минимум версия 1.67.0-1 пакета ecs-init.
Вы можете указать не более 100 диапазонов портов на контейнер.
Вы не указываете hostPortRange. Значение hostPortRange устанавливается следующим образом:
- Для контейнеров в задаче с режимом сети awsvpc, hostPortRange устанавливается равным значению containerPortRange. Это стратегия статического сопоставления.
- Для контейнеров в задаче с режимом сети bridge, агент Amazon ECS находит свободные порты хоста из стандартного диапазона временных портов и передает их Docker для привязки к портам контейнера.
Значение containerPortRange должно быть от 1 до 65535.
Порт может быть включен только в одном сопоставлении портов на контейнер.
Нельзя указывать перекрывающиеся диапазоны портов.
Первый порт в диапазоне должен быть меньше последнего порта в диапазоне.
Docker рекомендует отключить docker-proxy в файле конфигурации демона Docker, когда у вас много портов. Дополнительную информацию см. в проблеме #11185 на сайте Github. Сведения о том, как отключить docker-proxy в файле конфигурации демона Docker, см. в разделе Демон Docker в руководстве разработчика Amazon ECS.

Вы можете вызвать ` DescribeTasks https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeTasks.html`__ для просмотра hostPortRange, которые являются портами хоста, привязанными к портам контейнера.

hostPortRange -> (строка)

Диапазон номеров портов на хосте, используемый с сетевой привязкой. Это присваивается Docker и доставляется агентом Amazon ECS.

networkInterfaces -> (список)

Сетевые интерфейсы, связанные с контейнером.

(структура)

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

attachmentId -> (строка)

Идентификатор привязки сетевого интерфейса.

privateIpv4Address -> (строка)

Частный IPv4-адрес сетевого интерфейса.

ipv6Address -> (строка)

Частный IPv6-адрес сетевого интерфейса.

healthStatus -> (строка)

Состояние работоспособности контейнера. Если для этого контейнера в его определении задачи не настроены проверки работоспособности, то он сообщает состояние работоспособности как UNKNOWN.

managedAgents -> (список)

Подробности о любых управляемых агентах Amazon ECS, связанных с контейнером.

(структура)

Сведения о состоянии управляемого агента для контейнера.

lastStartedAt -> (временная метка)

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

name -> (строка)

Имя управляемого агента. Когда включена функция выполнения команды, имя управляемого агента — ExecuteCommandAgent.

reason -> (строка)

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

lastStatus -> (строка)

Последнее известное состояние управляемого агента.

cpu -> (строка)

Количество блоков процессора, установленных для контейнера. Значение — 0, если в определении контейнера при регистрации определения задачи не было указано никакого значения.

memory -> (строка)

Жесткий лимит памяти (в МБ) для контейнера.

memoryReservation -> (строка)

Мягкий лимит памяти (в МБ) для контейнера.

gpuIds -> (список)

Идентификаторы каждого GPU, назначенного контейнеру.

(строка)

cpu -> (строка)

Количество блоков процессора, используемых задачей, выраженное в определении задачи. Оно может быть выражено как целое число с использованием блоков процессора (например, 1024). Оно также может быть выражено как строка с использованием виртуальных процессоров (например, 1 vCPU или 1 vcpu). Строковые значения преобразуются в целое число, указывающее блоки процессора, при регистрации определения задачи.

Если вы используете тип запуска EC2 или внешний тип запуска, этот параметр необязателен. Поддерживаемые значения находятся в диапазоне от 128 блоков процессора (0.125 виртуальных процессоров) до 196608 блоков процессора (192 виртуальных процессоров). Если вы не указываете значение, параметр игнорируется.

Этот параметр обязателен для Fargate. Сведения о допустимых значениях см. в разделе Размер задачи в руководстве разработчика Amazon Elastic Container Service.

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

Временная метка Unix для времени создания задачи. Точнее, это время, когда задача перешла в состояние PENDING.

desiredStatus -> (строка)

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

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

Определяет, включена ли функция выполнения команды для этой задачи. Если true, функция выполнения команды включена для всех контейнеров в задаче.

executionStoppedAt -> (временная метка)

Временная метка Unix для времени остановки выполнения задачи.

group -> (строка)

Имя группы задач, связанной с задачей.

healthStatus -> (строка)

Статус работоспособности задачи. Он определяется работоспособностью необходимых контейнеров в задаче. Если все необходимые контейнеры в задаче сообщают о состоянии HEALTHY, статус задачи также сообщает о состоянии HEALTHY. Если какие-либо необходимые контейнеры в задаче сообщают о состоянии UNHEALTHY или UNKNOWN, статус задачи также сообщает о состоянии UNHEALTHY или UNKNOWN.

Примечание

Агент контейнера Amazon ECS не отслеживает и не сообщает о проверках работоспособности Docker, встроенных в образ контейнера и не указанных в определении контейнера. Например, это включает те, которые указаны в родительском изображении или в файле Dockerfile изображения. Параметры проверки работоспособности, указанные в определении контейнера, переопределяют любые проверки работоспособности Docker, найденные в образе контейнера.

inferenceAccelerators -> (список)

Ускоритель Elastic Inference, связанный с задачей.

(структура)

Подробная информация об ускорителе Elastic Inference. Дополнительную информацию см. в разделе Работа с Amazon Elastic Inference в Amazon ECS в Руководстве разработчика Amazon Elastic Container Service.

deviceName -> (строка)

Имя устройства ускорителя Elastic Inference. deviceName также должен быть указан в определении контейнера как ResourceRequirement.

deviceType -> (строка)

Тип ускорителя Elastic Inference, который следует использовать.

lastStatus -> (строка)

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

launchType -> (строка)

Инфраструктура, на которой выполняется ваша задача. Дополнительную информацию см. в разделе Типы запуска Amazon ECS в Руководстве разработчика Amazon Elastic Container Service.

memory -> (строка)

Объем памяти (в Мбайт), используемый задачей, выраженный в определении задачи. Он может быть выражен как целое число с использованием Мбайт (например, 1024). Если он выражен как строка с использованием Гбайт (например, 1GB или 1 GB), он преобразуется в целое число, указывающее Мбайт при регистрации определения задачи.

Если вы используете тип запуска EC2, это поле является необязательным.

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

512 (0,5 Гбайт), 1024 (1 Гбайт), 2048 (2 Гбайт) - Допустимые значения cpu: 256 (0,25 vCPU)
1024 (1 Гбайт), 2048 (2 Гбайт), 3072 (3 Гбайт), 4096 (4 Гбайт) - Допустимые значения cpu: 512 (0,5 vCPU)
2048 (2 Гбайт), 3072 (3 Гбайт), 4096 (4 Гбайт), 5120 (5 Гбайт), 6144 (6 Гбайт), 7168 (7 Гбайт), 8192 (8 Гбайт) - Допустимые значения cpu: 1024 (1 vCPU)
От 4096 (4 Гбайт) до 16384 (16 Гбайт) с шагом 1024 (1 Гбайт) - Допустимые значения cpu: 2048 (2 vCPU)
От 8192 (8 Гбайт) до 30720 (30 Гбайт) с шагом 1024 (1 Гбайт) - Допустимые значения cpu: 4096 (4 vCPU)
От 16 Гбайт до 60 Гбайт с шагом 4 Гбайт - Допустимые значения cpu: 8192 (8 vCPU) Этот вариант требует платформы Linux 1.4.0 или более поздней версии.
От 32 Гбайт до 120 Гбайт с шагом 8 Гбайт - Допустимые значения cpu: 16384 (16 vCPU) Этот вариант требует платформы Linux 1.4.0 или более поздней версии.

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

Одна или несколько переопределений контейнера.

containerOverrides -> (список)

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

(структура)

Переопределения, отправляемые в контейнер. Можно передать пустое переопределение контейнера. Пример пустого переопределения контейнера - {"containerOverrides": [ ] }. Если указано непустое переопределение контейнера, должен быть указан параметр name.

Для хранения конфиденциальных данных можно использовать Secrets Manager или Amazon Web Services Systems Manager Parameter Store. Дополнительную информацию см. в Руководстве по Amazon ECS, раздел Получение секретов через переменные среды.

name -> (строка)

Имя контейнера, который получает переопределение. Этот параметр требуется, если указано любое переопределение.

command -> (список)

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

(строка)

environment -> (список)

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

(структура)

Объект пары «ключ-значение».

name -> (строка)

Имя пары «ключ-значение». Для переменных среды это имя переменной среды.

value -> (строка)

Значение пары «ключ-значение». Для переменных среды это значение переменной среды.

environmentFiles -> (список)

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

(структура)

Список файлов, содержащих переменные среды, которые нужно передать контейнеру. Можно указать до десяти файлов среды. Файл должен иметь расширение .env. Каждая строка в файле среды должна содержать переменную среды в формате VARIABLE=VALUE. Строки, начинающиеся с #, рассматриваются как комментарии и игнорируются.

Если в определении контейнера указаны переменные среды с помощью параметра environment, они имеют приоритет над переменными, содержащимися в файле среды. Если несколько файлов среды содержат одну и ту же переменную, они обрабатываются сверху вниз. Рекомендуется использовать уникальные имена переменных. Дополнительную информацию см. в Руководстве разработчика Amazon Elastic Container Service, раздел Использование файла для передачи переменных среды в контейнер.

Файлы переменных среды находятся в Amazon S3, и на них распространяются все соображения безопасности Amazon S3.

Для типа запуска Fargate необходимо использовать следующие платформы:

Платформа Linux версии 1.4.0 или более поздней версии.
Платформа Windows версии 1.0.0 или более поздней версии.

При использовании типа запуска Fargate обратите внимание на следующее:

Файл обрабатывается как собственный Docker env-файл.
Обработка экранирования оболочки не поддерживается.
Точка входа контейнера интерпретирует значения VARIABLE.

value -> (строка)

Идентификатор ресурса Amazon (ARN) объекта Amazon S3, содержащего файл переменной среды.

type -> (строка)

Тип файла для использования. Файлы среды — это объекты в Amazon S3. Поддерживается только значение s3.

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

Количество единиц cpu, резервируемых для контейнера, вместо значения по умолчанию из определения задачи. Также необходимо указать имя контейнера.

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

Жесткий лимит (в Мбайт) памяти, предоставляемой контейнеру, вместо значения по умолчанию из определения задачи. Если контейнер пытается превысить указанный здесь объем памяти, контейнер завершается.

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

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

resourceRequirements -> (список)

Тип и объем ресурса, назначаемого контейнеру, вместо значения по умолчанию из определения задачи. Поддерживается только ресурс GPU.

(структура)

Тип и объем ресурса, назначаемого контейнеру. Поддерживаются типы ресурсов: GPU и ускорители Elastic Inference. Дополнительную информацию см. в Руководстве разработчика Amazon Elastic Container Service, разделах Работа с GPU в Amazon ECS или Работа с Amazon Elastic Inference в Amazon ECS.

value -> (строка)

Значение для указанного типа ресурса.

Когда тип — GPU, значение — количество физических GPUs, которые резервирует агент контейнера Amazon ECS для контейнера. Количество GPU, зарезервированных для всех контейнеров в задаче, не может превышать количество доступных GPU на экземпляре контейнера, на котором запущена задача.

Когда тип — InferenceAccelerator, значение value соответствует значению deviceName для ускорителя InferenceAccelerator, указанного в определении задачи.

type -> (строка)

Тип ресурса, который нужно назначить контейнеру.

cpu -> (строка)

Переопределение CPU для задачи.

inferenceAcceleratorOverrides -> (список)

Переопределение ускорителя Elastic Inference для задачи.

(структура)

Подробная информация о переопределении ускорителя Elastic Inference для задачи. Этот параметр используется для переопределения ускорителя Elastic Inference, указанного в определении задачи. Дополнительную информацию см. в разделе Работа с Amazon Elastic Inference в Amazon ECS в Руководстве разработчика Amazon Elastic Container Service.

deviceName -> (строка)

Имя устройства ускорителя Elastic Inference, которое нужно переопределить для задачи. Этот параметр должен совпадать с deviceName, указанным в определении задачи.

deviceType -> (строка)

Тип ускорителя Elastic Inference, который нужно использовать.

executionRoleArn -> (строка)

Идентификатор ресурса Amazon (ARN) переопределения роли выполнения задачи для задачи. Дополнительную информацию см. в разделе IAM-роль выполнения задачи Amazon ECS в Руководстве разработчика Amazon Elastic Container Service.

memory -> (строка)

Переопределение памяти для задачи.

taskRoleArn -> (строка)

Идентификатор ресурса Amazon (ARN) роли, которую контейнеры в этой задаче могут принять на себя. Всем контейнерам в этой задаче предоставляются разрешения, указанные в этой роли. Дополнительную информацию см. в разделе IAM-роль для задач в Руководстве разработчика Amazon Elastic Container Service.

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

Переопределение параметров временного хранилища для задачи.

Примечание

Этот параметр поддерживается только для задач, размещенных на Fargate, использующих следующие версии платформы:

Платформа Linux версии 1.4.0 или более поздней версии.
Платформа Windows версии 1.0.0 или более поздней версии.

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

Общий объем временного хранилища в Гбайт для задачи. Минимальное поддерживаемое значение — 21 Гбайт, а максимальное — 200 Гбайт.

platformVersion -> (строка)

Версия платформы, на которой выполняется ваша задача. Версия платформы указывается только для задач, использующих тип запуска Fargate. Если вы не указали её, используется версия платформы LATEST. Дополнительную информацию см. в разделе «Версии платформы Fargate» в руководстве разработчика Amazon Elastic Container Service.

platformFamily -> (строка)

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

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

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

Маркер времени Unix для начала извлечения образа контейнера.

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

Маркер времени Unix для завершения извлечения образа контейнера.

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

Маркер времени Unix для начала выполнения задачи. Точнее, это время, когда задача перешла из состояния PENDING в состояние RUNNING.

startedBy -> (строка)

Тег, указанный при запуске задачи. Если задачу запустила служба Amazon ECS, параметр startedBy содержит идентификатор развертывания этой службы.

stopCode -> (строка)

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

Дополнительную информацию о кодах остановки см. в разделе «Коды ошибок остановленных задач» в руководстве разработчика Amazon ECS.

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

Маркер времени Unix для остановки задачи. Точнее, это время, когда задача перешла из состояния RUNNING в состояние STOPPED.

stoppedReason -> (строка)

Причина остановки задачи.

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

Маркер времени Unix для остановки задачи. Точнее, это время, когда задача переходит из состояния RUNNING в состояние STOPPING.

tags -> (список)

Метаданные, которые вы применяете к задаче, чтобы помочь в ее категоризации и организации. Каждый тег состоит из ключа и необязательного значения. Вы определяете и ключ, и значение.

Применяются следующие основные ограничения к тегам:

Максимальное количество тегов на ресурс - 50
Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
Максимальная длина ключа - 128 Unicode-символов в UTF-8
Максимальная длина значения - 256 Unicode-символов в UTF-8
Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В целом, разрешенными символами являются: буквы, цифры и пробелы, представленные в UTF-8, а также следующие символы: + - = . _ : / @.
Ключи и значения тегов чувствительны к регистру.
Не используйте aws:, AWS: или любые сочетания верхнего и нижнего регистра таких префиксов для ключей или значений, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи или значения тегов с этим префиксом. Теги с этим префиксом не учитываются при подсчете лимита тегов на ресурс.

(структура)

Метаданные, которые вы применяете к ресурсу, чтобы помочь в их категоризации и организации. Каждый тег состоит из ключа и необязательного значения. Вы определяете их.

Применяются следующие основные ограничения к тегам:

Максимальное количество тегов на ресурс - 50
Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
Максимальная длина ключа - 128 Unicode-символов в UTF-8
Максимальная длина значения - 256 Unicode-символов в UTF-8
Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В целом, разрешенными символами являются: буквы, цифры и пробелы, представленные в UTF-8, а также следующие символы: + - = . _ : / @.
Ключи и значения тегов чувствительны к регистру.
Не используйте aws:, AWS: или любые сочетания верхнего и нижнего регистра таких префиксов для ключей или значений, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи или значения тегов с этим префиксом. Теги с этим префиксом не учитываются при подсчете лимита тегов на ресурс.

key -> (строка)

Одна часть пары ключ-значение, составляющей тег. Ключ — это общий ярлык, который действует как категория для более специфических значений тегов.

value -> (строка)

Необязательная часть пары ключ-значение, составляющей тег. Значение действует как описание в рамках категории тегов (ключ).

taskArn -> (строка)

Amazon Resource Name (ARN) задачи.

taskDefinitionArn -> (строка)

ARN определения задачи, создавшей задачу.

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

Счетчик версии задачи. Каждый раз, когда задача претерпевает изменения, которые запускают событие CloudWatch, счетчик версии увеличивается. Если вы реплицируете состояние своей задачи Amazon ECS с помощью CloudWatch Events, вы можете сравнить версию задачи, представленную действиями API Amazon ECS, с версией, представленной в CloudWatch Events для задачи (внутри объекта detail), чтобы проверить, что версия в вашем потоке событий актуальна.

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

Параметры временного хранения для задачи.

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

Общий объем временного хранилища в Гигабайтах для задачи. Минимальное поддерживаемое значение — 21 ГБ, а максимальное — 200 ГБ.

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

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

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

Общий объем временного хранилища в Гигабайтах для задачи. Минимальное поддерживаемое значение — 20 ГБ, а максимальное — 200 ГБ.

kmsKeyId -> (строка)

Укажите идентификатор ключа Key Management Service для шифрования временного хранилища задачи.