submit-job
Описание
Отправляет задачу Batch на основе определения задачи. Параметры, указанные при SubmitJob, переопределяют параметры, определенные в определении задачи. Исключение составляют требования к vCPU и памяти, указанные в объектах resourceRequirements в определении задачи. Их нельзя переопределить таким образом с помощью параметров memory и vcpus. Вместо этого необходимо указать обновления параметров определения задачи в объекте resourceRequirements, который включён в параметр containerOverrides.
Примечание
Очереди задач с политикой планирования ограничены 500 активными идентификаторами обмена в единицу времени.Предупреждение
Задачи, выполняемые на ресурсах Fargate, не гарантированно выполняются более 14 дней. Это связано с тем, что после 14 дней ресурсы Fargate могут стать недоступными, и задача может быть завершена.См. также: Документация API AWS
Синтаксис
submit-job
--job-name <value>
--job-queue <value>
[--share-identifier <value>]
[--scheduling-priority-override <value>]
[--array-properties <value>]
[--depends-on <value>]
--job-definition <value>
[--parameters <value>]
[--container-overrides <value>]
[--node-overrides <value>]
[--retry-strategy <value>]
[--propagate-tags | --no-propagate-tags]
[--timeout <value>]
[--tags <value>]
[--eks-properties-override <value>]
[--ecs-properties-override <value>]
[--consumable-resource-properties-override <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]
Параметры
--job-name (строка)
--job-queue (строка)
--share-identifier (строка)
Идентификатор обмена для задачи. Не указывайте этот параметр, если очередь задач не имеет политики планирования справедливого распределения. Если очередь задач имеет политику планирования справедливого распределения, то этот параметр должен быть указан.
Эта строка ограничена 255 буквенно-цифровыми символами и может быть дополнена звездочкой (*).
--scheduling-priority-override (целое число)
Приоритет планирования для задачи. Это влияет только на задачи в очередях задач с политикой справедливого распределения. Задачи с более высоким приоритетом планирования планируются перед задачами с более низким приоритетом планирования. Это переопределяет любой приоритет планирования в определении задачи и работает только в пределах одного идентификатора обмена.
Минимальное значение — 0, максимальное — 9999.
--array-properties (структура)
Свойства массива для отправляемой задачи, такие как размер массива. Размер массива может быть от 2 до 10 000. Если вы указываете свойства массива для задачи, она становится задачей массива. Дополнительную информацию см. в разделе «Задачи массива» в руководстве пользователя Batch.
size -> (целое число)
Сокращенный синтаксис:
size=integer
Синтаксис JSON:
{
"size": integer
}
--depends-on (список)
Список зависимостей для задачи. Задача может зависеть от максимального числа 20 задач. Вы можете указать зависимость типа SEQUENTIAL без указания идентификатора задачи для задач массива, чтобы каждая дочерняя задача массива завершалась последовательно, начиная с индекса 0. Вы также можете указать зависимость типа N_TO_N с идентификатором задачи для задач массива. В этом случае каждая дочерняя задача индекса этой задачи должна дождаться завершения соответствующей дочерней задачи каждого зависимого объекта, прежде чем сможет начать работу.
(структура)
Объект, представляющий зависимость задачи Batch.
jobId -> (строка)
type -> (строка)
Сокращенный синтаксис:
jobId=string,type=string ...
Синтаксис JSON:
[
{
"jobId": "string",
"type": "N_TO_N"|"SEQUENTIAL"
}
...
]
--job-definition (строка)
Определение задачи, используемое этой задачей. Это значение может быть одним из definition-name , definition-name:revision или Amazon Resource Name (ARN) для определения задачи, с или без ревизии (``arn:aws:batch:region :account :job-definition/definition-name :revision `` или ``arn:aws:batch:region :account :job-definition/definition-name `` ).
Если ревизия не указана, используется последняя активная ревизия.
--parameters (массив)
Дополнительные параметры, передаваемые задаче, которые заменяют параметры подстановки, заданные в определении задачи. Параметры задаются как сопоставление ключа и значения. Параметры в запросе SubmitJob переопределяют любые соответствующие параметры по умолчанию из определения задачи.
key -> (строка)
value -> (строка)
Сокращенный синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--container-overrides (структура)
Объект с свойствами, которые переопределяют значения по умолчанию для определения задания, задавая имя контейнера в указанном определении задания и переопределения, которые он должен получить. Вы можете переопределить команду по умолчанию для контейнера, которая указана в определении задания или в образе Docker, с помощью переопределения command. Также вы можете переопределить существующие переменные среды в контейнере или добавить новые переменные среды с помощью переопределения environment.
vcpus -> (целое число)
resourceRequirements для переопределения параметра vcpus, который задан в определении задания. Он не поддерживается для заданий, выполняемых на ресурсах Fargate. Для заданий, выполняемых на ресурсах Amazon EC2, он переопределяет параметр vcpus, заданный в определении задания, но не переопределяет требования к vCPU, указанные в структуре resourceRequirements в определении задания. Чтобы переопределить требования к vCPU, указанные в структуре resourceRequirements в определении задания, необходимо указать resourceRequirements в запросе SubmitJob, с type, установленным в VCPU, и value, установленным в новое значение. Дополнительную информацию см. в разделе «Невозможно переопределить требования к ресурсам определения задания» в руководстве пользователя Batch.memory -> (целое число)
resourceRequirements для переопределения требований к памяти, указанных в определении задания. Он не поддерживается для заданий, выполняемых на ресурсах Fargate. Для заданий, выполняемых на ресурсах Amazon EC2, он переопределяет параметр memory, заданный в определении задания, но не переопределяет требования к памяти, указанные в структуре resourceRequirements в определении задания. Чтобы переопределить требования к памяти, указанные в структуре resourceRequirements в определении задания, необходимо указать resourceRequirements в запросе SubmitJob, с type, установленным в MEMORY, и value, установленным в новое значение. Дополнительную информацию см. в разделе «Невозможно переопределить требования к ресурсам определения задания» в руководстве пользователя Batch.command -> (список)
Команда, отправляемая контейнеру, которая переопределяет команду по умолчанию из образа Docker или определения задания.
Примечание
Этот параметр не может содержать пустую строку.(строка)
instanceType -> (строка)
Тип экземпляра для использования в многоузловом параллельном задании.
Примечание
Этот параметр не применим к заданиям с одним узлом или заданиям, выполняемым на ресурсах Fargate, и не должен предоставляться.environment -> (список)
Переменные среды, которые необходимо отправить контейнеру. Вы можете добавлять новые переменные среды, которые добавляются в контейнер при запуске, или переопределять существующие переменные среды из образа Docker или определения задания.
Примечание
Переменные среды не могут начинаться с «AWS_BATCH». Эта соглашение об именовании зарезервировано для переменных, которые задает Batch.(структура)
Объект пар ключ-значение.
name -> (строка)
value -> (строка)
resourceRequirements -> (список)
Тип и количество ресурсов, которые необходимо назначить контейнеру. Это переопределяет параметры в определении задания. Поддерживаемые ресурсы включают GPU , MEMORY и VCPU .
(структура)
Тип и количество ресурса, который необходимо назначить контейнеру. Поддерживаемые ресурсы включают GPU , MEMORY и VCPU .
value -> (строка)
Количество указанного ресурса для резервирования контейнера. Значения зависят от указанного type.
Количество физических графических процессоров (GPU), которые нужно зарезервировать для контейнера. Убедитесь, что количество GPU, зарезервированных для всех контейнеров в задании, не превышает количество доступных GPU на вычислительном ресурсе, на котором запускается задание.
Примечание
GPU недоступны для заданий, выполняемых на ресурсах Fargate.
type=”MEMORY”
Максимальное ограничение памяти (в МБ) для контейнера. Этот параметр поддерживается для заданий, выполняемых на ресурсах Amazon EC2. Если контейнер пытается превысить указанную память, контейнер завершается. Этот параметр соответствует Memory в разделе «Создание контейнера» в удаленном API Docker и параметру --memory для docker run. Вы должны указать по крайней мере 4 МБ памяти для задания. Это необходимо, но может быть указано в нескольких местах для многоузловых параллельных заданий. Он должен быть указан для каждого узла как минимум один раз. Этот параметр соответствует Memory в разделе «Создание контейнера» в удаленном API Docker и параметру --memory для docker run.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя своим заданиям максимальное количество памяти для конкретного типа экземпляра, ознакомьтесь с управлением памятью в руководстве пользователя Batch.Для заданий, выполняемых на ресурсах Fargate, value является жестким ограничением (в МБ) и должно совпадать с одним из поддерживаемых значений, а VCPU должны быть одним из значений, поддерживаемых для данного значения памяти.
type -> (строка)
GPU , MEMORY и VCPU .Сокращенная синтаксическая запись:
vcpus=integer,memory=integer,command=string,string,instanceType=string,environment=[{name=string,value=string},{name=string,value=string}],resourceRequirements=[{value=string,type=string},{value=string,type=string}]
Синтаксис JSON:
{
"vcpus": integer,
"memory": integer,
"command": ["string", ...],
"instanceType": "string",
"environment": [
{
"name": "string",
"value": "string"
}
...
],
"resourceRequirements": [
{
"value": "string",
"type": "GPU"|"VCPU"|"MEMORY"
}
...
]
}
--node-overrides (структура)
Список замещений узлов в формате JSON, которые указывают диапазон узлов для обработки и параметры контейнера для этого диапазона узлов.
Примечание
Этот параметр не применим к задачам, выполняемым на ресурсах Fargate; используйтеcontainerOverrides вместо этого.numNodes -> (целое число)
Количество узлов для использования в многоузловой параллельной задаче. Это значение переопределяет количество узлов, указанное в определении задачи. Для использования этого замещения необходимо выполнить следующие условия:
- В определении задачи должен быть по крайней мере один диапазон узлов с открытой верхней границей, например
:илиn:. - Нижняя граница диапазона узлов, указанного в определении задачи, должна быть меньше, чем количество узлов, указанное в замещении.
- Основной индекс узла, указанный в определении задачи, должен быть меньше, чем количество узлов, указанное в замещении.
nodePropertyOverrides -> (список)
Параметры замещения свойств узлов для задачи.
(структура)
Объект, представляющий любые замещения свойств узлов в определении задачи, используемом в операции SubmitJob API.
targetNodes -> (строка)
0:3 указывает узлы с индексами от 0 до 3 . Если начальное значение диапазона опущено (:n), то используется 0 для начала диапазона. Если конечное значение диапазона опущено (n:), то используется максимальный возможный индекс узла для конца диапазона.containerOverrides -> (структура)
Замещения, которые отправляются в диапазон узлов.
vcpus -> (целое число)
resourceRequirements для переопределения параметра vcpus, заданного в определении задачи. Он не поддерживается для задач, выполняемых на ресурсах Fargate. Для задач, выполняемых на ресурсах Amazon EC2, он переопределяет параметр vcpus, заданный в определении задачи, но не переопределяет требования к vCPU, указанные в структуре resourceRequirements в определении задачи. Для переопределения требований к vCPU, указанных в структуре resourceRequirements в определении задачи, необходимо указать resourceRequirements в запросе SubmitJob, с type, установленным на VCPU, и value, установленным на новое значение. Дополнительную информацию см. в разделе «Невозможно переопределить требования к ресурсам определения задачи» в руководстве пользователя Batch.memory -> (целое число)
resourceRequirements для переопределения требований к памяти, указанных в определении задачи. Он не поддерживается для задач, выполняемых на ресурсах Fargate. Для задач, выполняемых на ресурсах Amazon EC2, он переопределяет параметр memory, заданный в определении задачи, но не переопределяет требования к памяти, указанные в структуре resourceRequirements в определении задачи. Для переопределения требований к памяти, указанных в структуре resourceRequirements в определении задачи, необходимо указать resourceRequirements в запросе SubmitJob, с type, установленным на MEMORY, и value, установленным на новое значение. Дополнительную информацию см. в разделе «Невозможно переопределить требования к ресурсам определения задачи» в руководстве пользователя Batch.command -> (список)
Команда, отправляемая в контейнер, которая переопределяет стандартную команду из образа Docker или определения задачи.
Примечание
Этот параметр не может содержать пустую строку.(строка)
instanceType -> (строка)
Тип экземпляра для использования в многоузловой параллельной задаче.
Примечание
Этот параметр не применим к задачам с одним узлом или задачам, выполняемым на ресурсах Fargate, и не должен предоставляться.environment -> (список)
Переменные среды, которые нужно отправить в контейнер. Вы можете добавлять новые переменные среды, которые добавляются в контейнер при запуске, или переопределять существующие переменные среды из образа Docker или определения задачи.
Примечание
Имена переменных среды не могут начинаться с «AWS_BATCH». Этот соглашение по именованию зарезервировано для переменных, которые устанавливает Batch.(структура)
Объект пары «ключ-значение».
name -> (строка)
value -> (строка)
resourceRequirements -> (список)
Тип и количество ресурсов для назначения контейнеру. Это переопределяет параметры в определении задачи. Поддерживаемые ресурсы включают GPU, MEMORY и VCPU.
(структура)
Тип и количество ресурса для назначения контейнеру. Поддерживаемые ресурсы включают GPU, MEMORY и VCPU.
value -> (строка)
Количество указанного ресурса для резервирования контейнера. Значения зависят от указанного type.
Количество физических графических процессоров (GPU), которые нужно зарезервировать для контейнера. Убедитесь, что количество зарезервированных GPU для всех контейнеров в задаче не превышает количество доступных GPU на вычислительном ресурсе, на котором запускается задача.
Примечание
GPU недоступны для задач, выполняемых на ресурсах Fargate.type=”MEMORY”
Максимальный объем памяти (в МБ), выделенный контейнеру. Этот параметр поддерживается для задач, выполняемых на ресурсах Amazon EC2. Если контейнер попытается превысить заданный объем памяти, контейнер будет завершен. Этот параметр соответствует Memory в разделе «Создание контейнера» в API Docker Remote и параметру --memory в docker run. Для задачи необходимо указать не менее 4 МБ памяти. Это требование, которое может быть указано в нескольких местах для многоузловых параллельных задач (MNP). Оно должно быть указано для каждого узла как минимум один раз. Этот параметр соответствует Memory в разделе «Создание контейнера» в API Docker Remote и параметру --memory в docker run.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя своим задачам максимально возможное количество памяти для определенного типа экземпляра, см. раздел «Управление памятью» в руководстве пользователя Batch.Для задач, выполняемых на ресурсах Fargate, value — это максимальный лимит (в МБ), который должен совпадать с одним из поддерживаемых значений, а значения VCPU должны быть одним из значений, поддерживаемых для этого значения памяти.
type -> (строка)
GPU, MEMORY и VCPU.ecsPropertiesOverride -> (структура)
Объект, содержащий свойства, которые вы хотите заменить для существующих ресурсов Amazon ECS для задания.
taskProperties -> (список)
Замены для определения задачи Amazon ECS задания.
Примечание
В настоящее время этот объект ограничен одним элементом.(структура)
Объект, содержащий замены для определения задачи задания.
containers -> (список)
Замены для определения контейнера задания.
(структура)
Замены, которые должны быть отправлены контейнеру.
Дополнительную информацию об использовании замещений Batch при подключении источников событий к целевым объектам см. в разделе BatchContainerOverrides.
command -> (список)
Команда, отправляемая контейнеру, которая заменяет стандартную команду из Docker-образа или определения задания.
Примечание
Этот параметр не может содержать пустую строку.(строка)
environment -> (список)
Переменные среды, которые нужно отправить в контейнер. Можно добавлять новые переменные среды, которые добавляются в контейнер при запуске, или можно перезаписывать существующие переменные среды из Docker-образа или определения задания.
Примечание
Переменные среды не могут начинаться сAWS_BATCH. Эта соглашение об именах зарезервировано для переменных, которые устанавливает Batch.(структура)
Объект пар ключ-значение.
name -> (строка)
value -> (строка)
name -> (строка)
resourceRequirements -> (список)
Тип и количество ресурсов, которые необходимо назначить контейнеру. Это заменяет параметры в определении задания. Поддерживаемые ресурсы включают GPU , MEMORY и VCPU .
(структура)
Тип и количество ресурса, который необходимо назначить контейнеру. Поддерживаемые ресурсы включают GPU , MEMORY и VCPU .
value -> (строка)
Количество указанного ресурса для резервирования контейнером. Значения зависят от указанного параметра type.
Количество физических графических процессоров (GPU), которые необходимо зарезервировать для контейнера. Убедитесь, что количество графических процессоров (GPU), зарезервированных для всех контейнеров в задании, не превышает количество доступных графических процессоров (GPU) на вычислительных ресурсах, на которых запускается задание.
Примечание
Графические процессоры (GPU) недоступны для заданий, выполняемых на ресурсах Fargate.
type=”MEMORY”
Жесткий лимит памяти (в МБ), предоставляемый контейнеру. Этот параметр поддерживается для заданий, выполняемых на ресурсах Amazon EC2. Если контейнер попытается превысить указанный объем памяти, контейнер будет завершен. Этот параметр соответствует Memory в разделе «Создание контейнера» в Docker Remote API и параметру --memory для docker run. Для задания необходимо указать как минимум 4 МБ памяти. Это необходимо, но может быть указано в нескольких местах для заданий параллельной обработки на нескольких узлах (MNP). Он должен быть указан для каждого узла как минимум один раз. Этот параметр соответствует Memory в разделе «Создание контейнера» в Docker Remote API и параметру --memory для docker run.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя заданиям как можно больше памяти для конкретного типа экземпляра, ознакомьтесь с управлением памятью в Руководстве пользователя Batch.Для заданий, выполняемых на ресурсах Fargate, value является жестким лимитом (в МБ) и должен соответствовать одному из поддерживаемых значений, а VCPU значения должны быть одним из значений, поддерживаемых для этого значения памяти.
VCPU = 0,25
VCPU = 0,25 или 0,5
VCPU = 0,25, 0,5 или 1
VCPU = 0,5 или 1
VCPU = 0,5, 1 или 2
VCPU = 1 или 2
VCPU = 1, 2 или 4
VCPU = 2 или 4
VCPU = 2, 4 или 8
VCPU = 4
VCPU = 4 или 8
VCPU = 8
VCPU = 8 или 16
VCPU = 16
Количество виртуальных процессоров (vCPU), зарезервированных для контейнера. Этот параметр соответствует CpuShares в разделе «Создание контейнера» в Docker Remote API и параметру --cpu-shares для docker run. Каждый vCPU эквивалентен 1024 долям процессора. Для ресурсов Amazon EC2 необходимо указать как минимум один vCPU. Это необходимо, но может быть указано в нескольких местах; он должен быть указан для каждого узла как минимум один раз.
Значение по умолчанию для квоты на количество vCPU для Fargate On-Demand составляет 6 vCPU. Дополнительную информацию о квотах Fargate см. в разделе Квоты Fargate в Общие сведения об Amazon Web Services.
Для заданий, выполняемых на ресурсах Fargate, value должно соответствовать одному из поддерживаемых значений, а MEMORY значения должны быть одним из значений, поддерживаемых для этого значения VCPU. Поддерживаемые значения: 0,25, 0,5, 1, 2, 4, 8 и 16
MEMORY = 512, 1024 или 2048
MEMORY = 1024, 2048, 3072 или 4096
MEMORY = 2048, 3072, 4096, 5120, 6144, 7168 или 8192
MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360 или 16384
MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696 или 30720
MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344 или 61440
MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688 или 122880
type -> (строка)
GPU , MEMORY и VCPU .instanceTypes -> (список)
Объект, содержащий типы экземпляров, которые вы хотите заменить для существующих ресурсов задания.
(строка)
eksPropertiesOverride -> (структура)
Объект, содержащий свойства, которые вы хотите заменить для существующих ресурсов Amazon EKS задачи.
podProperties -> (структура)
Замены для ресурсов Kubernetes pod задачи.
containers -> (список)
Замены для контейнера, используемого в pod Amazon EKS.
(структура)
Объект, представляющий любые замены Kubernetes для определения задачи, используемого в операции API SubmitJob.
name -> (строка)
image -> (строка)
command -> (список)
Команда для отправки контейнеру, заменяющая стандартную команду из Docker-изображения или определения задачи.
(строка)
args -> (список)
Аргументы для точки входа в контейнер, заменяющие стандартные аргументы из Docker-изображения или определения задачи. Дополнительная информация см. в справке Dockerfile: CMD и Определение команды и аргументов для pod в документации Kubernetes.
(строка)
env -> (список)
Переменные среды, которые нужно отправить контейнеру. Вы можете добавить новые переменные среды, которые добавляются в контейнер при запуске. Или вы можете заменить существующие переменные среды из Docker-изображения или определения задачи.
Примечание
Переменные среды не могут начинаться с «AWS_BATCH». Эта система именования зарезервирована для переменных, которые устанавливает Batch.(структура)
Переменная среды.
name -> (строка)
value -> (строка)
resources -> (структура)
Тип и количество ресурсов, которые нужно назначить контейнеру. Эти значения заменяют настройки в определении задачи. Поддерживаемые ресурсы включают memory , cpu и nvidia.com/gpu . Дополнительная информация см. в документации Kubernetes: Управление ресурсами для pod и контейнеров.
limits -> (карта)
Тип и количество ресурсов, которые нужно зарезервировать для контейнера. Значения зависят от указанного name. Ресурсы можно запросить, используя объекты limits или requests.
Максимальное ограничение памяти (в MiB) для контейнера, используя целые числа с суффиксом «Mi». Если контейнер попытается превысить заданный объем памяти, контейнер будет завершен. Для задачи необходимо указать как минимум 4 MiB памяти. memory можно указать в limits , requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits , должно быть равно значению, указанному в requests.
Примечание
Для максимального использования ресурсов предоставьте задачам как можно больше памяти для используемого типа экземпляра. Подробнее см. Управление памятью в Руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть целым числом, кратным 0.25. cpu можно указать в limits , requests или в обоих. Если cpu указано в обоих местах, то значение, указанное в limits , должно быть как минимум не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. memory можно указать в limits , requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits , должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
requests -> (карта)
Тип и количество ресурсов, которые нужно запросить для контейнера. Значения зависят от указанного name. Ресурсы можно запросить, используя объекты limits или requests.
Максимальное ограничение памяти (в MiB) для контейнера, используя целые числа с суффиксом «Mi». Если контейнер попытается превысить заданный объем памяти, контейнер будет завершен. Для задачи необходимо указать как минимум 4 MiB памяти. memory можно указать в limits , requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits , должно быть равно значению, указанному в requests.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя задачам как можно больше памяти для определенного типа экземпляра, см. Управление памятью в Руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть целым числом, кратным 0.25. cpu можно указать в limits , requests или в обоих. Если cpu указано в обоих местах, то значение, указанное в limits , должно быть как минимум не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. nvidia.com/gpu можно указать в limits , limits , или requests. Если nvidia.com/gpu указано в обоих местах, то значение, указанное в limits , должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
initContainers -> (список)
Переопределения для initContainers, определённых в узле Amazon EKS. Эти контейнеры выполняются перед контейнерами приложения, всегда доводятся до завершения и должны завершиться успешно перед запуском следующего контейнера. Эти контейнеры зарегистрированы с агентом Amazon EKS Connector и сохраняют информацию о регистрации в хранилище данных Kubernetes. Дополнительную информацию см. в разделе Init Containers в документации Kubernetes.
(структура)
Объект, представляющий любые переопределения Kubernetes для определения задания, используемого в операции API SubmitJob.
name -> (строка)
image -> (строка)
command -> (список)
Команда, отправляемая контейнеру, которая переопределяет командную строку по умолчанию из образа Docker или определения задания.
(строка)
args -> (список)
Аргументы для точки входа, отправляемые контейнеру, которые переопределяют аргументы по умолчанию из образа Docker или определения задания. Дополнительную информацию см. в справке Dockerfile: CMD и Определение команды и аргументов для узла в документации Kubernetes.
(строка)
env -> (список)
Переменные среды, отправляемые контейнеру. Вы можете добавить новые переменные среды, которые будут добавлены в контейнер при запуске. Или вы можете переопределить существующие переменные среды из образа Docker или определения задания.
Примечание
Переменные среды не могут начинаться с “AWS_BATCH”. Эта соглашение об именовании зарезервировано для переменных, которые устанавливаются Batch.(структура)
Переменная среды.
name -> (строка)
value -> (строка)
resources -> (структура)
Тип и количество ресурсов, которые необходимо назначить контейнеру. Они переопределяют настройки в определении задания. Поддерживаемые ресурсы включают memory, cpu и nvidia.com/gpu. Дополнительную информацию см. в разделе Управление ресурсами для узлов и контейнеров в документации Kubernetes.
limits -> (карта)
Тип и количество ресурсов, которые необходимо зарезервировать для контейнера. Значения зависят от указанного name. Ресурсы можно запросить, используя либо объекты limits, либо requests.
Предельное значение памяти (в МБ) для контейнера, используя целые числа с суффиксом «МБ». Если контейнер пытается превысить заданную память, контейнер завершается. Для задания необходимо указать как минимум 4 МБ памяти. memory может быть указано в limits, requests или обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Для максимального использования ресурсов предоставьте заданиям как можно больше памяти для конкретного типа экземпляра, который вы используете. Как это сделать, см. в разделе Управление памятью в руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть чётным кратным 0.25. cpu может быть указано в limits, requests или обоих. Если cpu указано в обоих местах, то значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. memory может быть указано в limits, requests или обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
requests -> (карта)
Тип и количество ресурсов, которые необходимо запросить для контейнера. Значения зависят от указанного name. Ресурсы можно запросить, используя либо объекты limits, либо requests.
Предельное значение памяти (в МБ) для контейнера, используя целые числа с суффиксом «МБ». Если контейнер пытается превысить заданную память, контейнер завершается. Для задания необходимо указать как минимум 4 МБ памяти. memory может быть указано в limits, requests или обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя заданиям как можно больше памяти для конкретного типа экземпляра, см. раздел Управление памятью в руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть чётным кратным 0.25. cpu может быть указано в limits, requests или обоих. Если cpu указано в обоих местах, то значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. nvidia.com/gpu может быть указано в limits, requests или обоих. Если nvidia.com/gpu указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
metadata -> (структура)
Метаданные о переопределениях для контейнера, используемого в узле Amazon EKS.
labels -> (карта)
Ключевые пары, используемые для идентификации, сортировки и организации ресурсов куба. Может содержать до 63 заглавных букв, строчных букв, цифр, дефисов (-) и знаков подчеркивания (_). Метки можно добавлять или изменять в любое время. Каждый ресурс может иметь несколько меток, но каждый ключ должен быть уникальным для данного объекта.
key -> (строка)
value -> (строка)
annotations -> (карта)
Ключевые пары, используемые для добавления произвольных, не идентифицирующих метаданных к объектам Kubernetes. Действительные ключи аннотаций имеют два сегмента: необязательный префикс и имя, разделенные косой чертой (/).
- Префикс необязателен и должен содержать не более 253 символов. Если указан, префикс должен быть поддоменом DNS — серией меток DNS, разделенных точками (.), и должен заканчиваться косой чертой (/).
- Сегмент имени обязателен и должен содержать не более 63 символов. Он может включать буквенно-цифровые символы ([a-z0-9A-Z]), дефисы (-), знаки подчеркивания (_) и точки (.), но должен начинаться и заканчиваться буквенно-цифровым символом.
Примечание
Значения аннотаций должны содержать не более 255 символов.Аннотации можно добавлять или изменять в любое время. Каждый ресурс может иметь несколько аннотаций.
key -> (строка)
value -> (строка)
namespace -> (строка)
Пространство имен кластера Amazon EKS. В Kubernetes пространства имен обеспечивают механизм изоляции групп ресурсов в одном кластере. Имена ресурсов должны быть уникальными в пределах пространства имен, но не во всех пространствах имен. Batch помещает узлы Batch Job в это пространство имен. Если это поле указано, значение не может быть пустым или нулевым. Оно должно соответствовать следующим требованиям:
- Длина от 1 до 63 символов
- Не может быть установлено на значение по умолчанию
- Не может начинаться с
kube - Должно соответствовать следующему регулярному выражению:
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Дополнительную информацию см. в разделе Пространства имен в документации Kubernetes. Это пространство имен может отличаться от kubernetesNamespace, заданного в вычислительной среде EksConfiguration, но должно иметь идентичные роли управления доступом на основе ролей (RBAC) как вычислительная среда kubernetesNamespace. Для заданий с параллельным выполнением на нескольких узлах необходимо указать одинаковое значение для всех диапазонов узлов.
consumableResourcePropertiesOverride -> (структура)
Объект, содержащий переопределения для потребляемых ресурсов задания.
consumableResourceList -> (список)
Список потребляемых ресурсов, необходимых заданию.
(структура)
Информация о потребляемом ресурсе, необходимом для выполнения задания.
consumableResource -> (строка)
quantity -> (целое число)
Синтаксис JSON:
{
"numNodes": integer,
"nodePropertyOverrides": [
{
"targetNodes": "string",
"containerOverrides": {
"vcpus": integer,
"memory": integer,
"command": ["string", ...],
"instanceType": "string",
"environment": [
{
"name": "string",
"value": "string"
}
...
],
"resourceRequirements": [
{
"value": "string",
"type": "GPU"|"VCPU"|"MEMORY"
}
...
]
},
"ecsPropertiesOverride": {
"taskProperties": [
{
"containers": [
{
"command": ["string", ...],
"environment": [
{
"name": "string",
"value": "string"
}
...
],
"name": "string",
"resourceRequirements": [
{
"value": "string",
"type": "GPU"|"VCPU"|"MEMORY"
}
...
]
}
...
]
}
...
]
},
"instanceTypes": ["string", ...],
"eksPropertiesOverride": {
"podProperties": {
"containers": [
{
"name": "string",
"image": "string",
"command": ["string", ...],
"args": ["string", ...],
"env": [
{
"name": "string",
"value": "string"
}
...
],
"resources": {
"limits": {"string": "string"
...},
"requests": {"string": "string"
...}
}
}
...
],
"initContainers": [
{
"name": "string",
"image": "string",
"command": ["string", ...],
"args": ["string", ...],
"env": [
{
"name": "string",
"value": "string"
}
...
],
"resources": {
"limits": {"string": "string"
...},
"requests": {"string": "string"
...}
}
}
...
],
"metadata": {
"labels": {"string": "string"
...},
"annotations": {"string": "string"
...},
"namespace": "string"
}
}
},
"consumableResourcePropertiesOverride": {
"consumableResourceList": [
{
"consumableResource": "string",
"quantity": long
}
...
]
}
}
...
]
}
--retry-strategy (структура)
Стратегия повторной попытки для задач, завершившихся ошибкой в рамках операции SubmitJob. Если здесь указана стратегия повторной попытки, она переопределяет стратегию повторной попытки, определённую в определении задачи.
attempts -> (целое число)
RUNNABLE. Можно указать от 1 до 10 попыток. Если значение attempts больше единицы, задача будет повторно выполняться столько же раз, сколько указано в этом значении.evaluateOnExit -> (список)
Массив из не более чем 5 объектов, которые определяют условия, при которых задачи будут повторно выполняться или завершаться ошибкой. Если этот параметр указан, то также должен быть указан параметр attempts. Если ни одно из перечисленных условий не соответствует, задача выполняется повторно.
(структура)
Указывает массив из не более чем 5 условий, которые должны быть выполнены, а также действие, которое будет выполнено (RETRY или EXIT), если все условия выполнены. Если ни одно из EvaluateOnExit условий в RetryStrategy не соответствует, задача выполняется повторно.
onStatusReason -> (строка)
StatusReason, возвращаемым для задачи. Шаблон может содержать до 512 символов. Он может содержать буквы, цифры, точки (.), двоеточия (:), пробелы (включая пробелы и табуляцию). Он может необязательно заканчиваться звездочкой (*), чтобы соответствовало только начало строки.onReason -> (строка)
Reason. Шаблон может содержать до 512 символов. Он может содержать буквы, цифры, точки (.), двоеточия (:) и пробелы (включая пробелы и табуляцию). Он может необязательно заканчиваться звездочкой (*), чтобы соответствовало только начало строки.onExitCode -> (строка)
Содержит шаблон glob для сопоставления с десятичным представлением значения ExitCode, возвращаемого для задачи. Шаблон может содержать до 512 символов. Он может содержать только цифры и может заканчиваться звездочкой (*), чтобы соответствовало только начало строки.
Строка может содержать до 512 символов.
action -> (строка)
onStatusReason , onReason и onExitCode) выполнены. Значения не чувствительны к регистру.Сокращённый синтаксис:
attempts=integer,evaluateOnExit=[{onStatusReason=string,onReason=string,onExitCode=string,action=string},{onStatusReason=string,onReason=string,onExitCode=string,action=string}]
Синтаксис JSON:
{
"attempts": integer,
"evaluateOnExit": [
{
"onStatusReason": "string",
"onReason": "string",
"onExitCode": "string",
"action": "RETRY"|"EXIT"
}
...
]
}
--propagate-tags | --no-propagate-tags (булево)
FAILED. При указании этого параметра он переопределяет настройку распространения тегов в определении задачи.--timeout (структура)
Настройка таймаута для операции SubmitJob. Можно указать время таймаута, после которого Batch завершает задачи, если они не завершены. Если задача завершается из-за таймаута, она не повторяется. Минимальное значение таймаута составляет 60 секунд. Эта настройка переопределяет любую настройку таймаута, указанную в определении задачи. Для задач массивов дочерние задачи имеют ту же настройку таймаута, что и родительская задача массива. Дополнительную информацию см. в разделе «Таймауты задач» в руководстве разработчика Amazon Elastic Container Service.
attemptDurationSeconds -> (целое число)
Время таймаута задачи (в секундах), измеряемое с момента метки времени startedAt попытки выполнения задачи. По истечении этого времени Batch завершает задачи, если они не завершены. Минимальное значение таймаута составляет 60 секунд.
Для задач массивов таймаут применяется к дочерним задачам, а не к родительской задаче массива.
Для задач параллельного выполнения с несколькими узлами (MNP) таймаут применяется ко всей задаче, а не к отдельным узлам.
Сокращённый синтаксис:
attemptDurationSeconds=integer
Синтаксис JSON:
{
"attemptDurationSeconds": integer
}
--tags (массив)
Теги, которые вы применяете к запросу на задачу, чтобы помочь в категоризации и организации ваших ресурсов. Каждый тег состоит из ключа и необязательного значения. Дополнительную информацию см. в разделе «Использование тегов для ресурсов Amazon Web Services» в общей справке Amazon Web Services.
key -> (строка)
value -> (строка)
Сокращённый синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--eks-properties-override (структура)
Объект со свойствами, которые переопределяют значения по умолчанию для определения задачи. Он может быть указан только для задач, выполняемых на ресурсах Amazon EKS.
podProperties -> (структура)
Переопределения ресурсов Kubernetes под для задачи.
containers -> (список)
Переопределения контейнера, используемого в под Amazon EKS.
(структура)
Объект, представляющий любые переопределения Kubernetes для определения задачи, используемого в операции SubmitJob API.
name -> (строка)
image -> (строка)
command -> (список)
Команда, отправляемая контейнеру, которая переопределяет команду по умолчанию из Docker-изображения или определения задачи.
(строка)
args -> (список)
Аргументы для точки входа, отправляемые контейнеру, которые переопределяют аргументы по умолчанию из Docker-изображения или определения задачи. Дополнительную информацию см. в справке Dockerfile: CMD и Определение команды и аргументов для под в документации Kubernetes.
(строка)
env -> (список)
Переменные среды, которые необходимо отправить контейнеру. Можно добавить новые переменные среды, которые будут добавлены к контейнеру при запуске. Или можно переопределить существующие переменные среды из Docker-изображения или определения задачи.
Примечание
Переменные среды не могут начинаться с «AWS_BATCH». Эта схема именования зарезервирована для переменных, устанавливаемых Batch.(структура)
Переменная среды.
name -> (строка)
value -> (строка)
resources -> (структура)
Тип и объём ресурсов, назначаемых контейнеру. Они переопределяют значения в определении задачи. Поддерживаемые ресурсы включают memory, cpu и nvidia.com/gpu. Дополнительную информацию см. в разделе Управление ресурсами для под и контейнеров в документации Kubernetes.
limits -> (массив)
Тип и объём ресурсов, резервируемых для контейнера. Значения зависят от указанного name. Ресурсы могут быть запрошены с помощью объектов limits или requests.
Предельное значение памяти (в Мбайтах) для контейнера, используя целые числа с суффиксом «Мб». Если контейнер пытается превысить указанный объём памяти, он завершается. Для задачи необходимо указать не менее 4 Мбайт памяти. memory может быть указано в limits, requests или в обоих. Если memory указано в обоих местах, значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Чтобы максимизировать использование ресурсов, предоставьте задачам как можно больше памяти для используемого типа экземпляра. Подробнее см. в разделе Управление памятью в руководстве пользователя Batch.
cpu
Количество процессоров, резервируемых для контейнера. Значения должны быть чётными кратными 0.25. cpu может быть указано в limits, requests или в обоих. Если cpu указано в обоих местах, значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, резервируемых для контейнера. Значения должны быть целыми числами. memory может быть указано в limits, requests или в обоих. Если memory указано в обоих местах, значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
requests -> (массив)
Тип и количество ресурсов, запрашиваемых для контейнера. Значения зависят от указанного name. Ресурсы могут быть запрошены с помощью объектов limits или requests.
Предельное значение памяти (в Мбайтах) для контейнера, используя целые числа с суффиксом «Мб». Если контейнер пытается превысить указанный объём памяти, он завершается. Для задачи необходимо указать не менее 4 Мбайт памяти. memory может быть указано в limits, requests или в обоих. Если memory указано в обоих местах, значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя задачам как можно больше памяти для определённого типа экземпляра, обратитесь к разделу Управление памятью в руководстве пользователя Batch.
cpu
Количество процессоров, резервируемых для контейнера. Значения должны быть чётными кратными 0.25. cpu может быть указано в limits, requests или в обоих. Если cpu указано в обоих местах, значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, резервируемых для контейнера. Значения должны быть целыми числами. nvidia.com/gpu может быть указано в limits, requests или в обоих. Если nvidia.com/gpu указано в обоих местах, значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
initContainers -> (список)
Переопределения для initContainers, определённых в под Amazon EKS. Эти контейнеры запускаются перед контейнерами приложения, всегда доводятся до завершения и должны завершиться успешно перед запуском следующего контейнера. Эти контейнеры регистрируются с агентом Amazon EKS Connector и сохраняют информацию о регистрации в хранилище данных Kubernetes. Дополнительную информацию см. в разделе Init Containers в документации Kubernetes.
(структура)
Объект, представляющий любые переопределения Kubernetes в определении задания, используемом в операции API SubmitJob.
name -> (строка)
image -> (строка)
command -> (список)
Команда, отправляемая в контейнер, которая переопределяет команду по умолчанию из Docker-изображения или определения задания.
(строка)
args -> (список)
Аргументы для точки входа, отправляемые в контейнер, которые переопределяют аргументы по умолчанию из Docker-изображения или определения задания. Дополнительную информацию см. в справке по Dockerfile: CMD и Определение команды и аргументов для пода в документации Kubernetes.
(строка)
env -> (список)
Переменные среды, отправляемые в контейнер. Вы можете добавлять новые переменные среды, которые добавляются в контейнер при запуске. Или вы можете переопределить существующие переменные среды из Docker-изображения или определения задания.
Примечание
Переменные среды не могут начинаться с “AWS_BATCH”. Эта конвенция имён зарезервирована для переменных, которые устанавливает Batch.(структура)
Переменная среды.
name -> (строка)
value -> (строка)
resources -> (структура)
Тип и количество ресурсов, которые необходимо назначить контейнеру. Эти значения переопределяют настройки в определении задания. Поддерживаемые ресурсы включают memory, cpu и nvidia.com/gpu. Дополнительную информацию см. в разделе Управление ресурсами для подов и контейнеров в документации Kubernetes.
limits -> (карта)
Тип и количество ресурсов, которые необходимо зарезервировать для контейнера. Значения зависят от name. Ресурсы можно запросить, используя объекты limits или requests.
Максимальное значение памяти (в МБ) для контейнера, используя целые числа с суффиксом «МБ». Если ваш контейнер пытается превысить указанное значение памяти, контейнер завершается. Для задания необходимо указать не менее 4 МБ памяти. memory можно указать в limits, requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Для максимального использования ресурсов предоставьте своим заданиям как можно больше памяти для конкретного типа экземпляра, который вы используете. Чтобы узнать как, см. Управление памятью в руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть чётным кратным 0.25. cpu можно указать в limits, requests или в обоих. Если cpu указано в обоих местах, то значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. memory можно указать в limits, requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
requests -> (карта)
Тип и количество ресурсов, запрашиваемых для контейнера. Значения зависят от name. Ресурсы можно запросить, используя объекты limits или requests.
Максимальное значение памяти (в МБ) для контейнера, используя целые числа с суффиксом «МБ». Если ваш контейнер пытается превысить указанное значение памяти, контейнер завершается. Для задания необходимо указать не менее 4 МБ памяти. memory можно указать в limits, requests или в обоих. Если memory указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя своим заданиям как можно больше памяти для конкретного типа экземпляра, см. Управление памятью в руководстве пользователя Batch.
cpu
Количество ЦП, зарезервированных для контейнера. Значения должны быть чётным кратным 0.25. cpu можно указать в limits, requests или в обоих. Если cpu указано в обоих местах, то значение, указанное в limits, должно быть не меньше значения, указанного в requests.
Количество графических процессоров, зарезервированных для контейнера. Значения должны быть целыми числами. nvidia.com/gpu можно указать в limits, requests или в обоих. Если nvidia.com/gpu указано в обоих местах, то значение, указанное в limits, должно быть равно значению, указанному в requests.
key -> (строка)
value -> (строка)
metadata -> (структура)
Метаданные о переопределениях для контейнера, используемого в под Amazon EKS.
labels -> (карта)
Ключ-значение пары, используемые для идентификации, сортировки и организации ресурсов куба. Могут содержать до 63 заглавных и строчных букв, цифр, дефисов (-) и подчеркиваний (_). Метки могут быть добавлены или изменены в любое время. Каждый ресурс может иметь несколько меток, но каждый ключ должен быть уникальным для данного объекта.
key -> (строка)
value -> (строка)
annotations -> (карта)
Ключ-значение пары, используемые для прикрепления произвольных, не идентифицирующих метаданных к объектам Kubernetes. Действительные ключи аннотаций имеют два сегмента: необязательный префикс и имя, разделенные косой чертой (/).
- Префикс является необязательным и должен содержать не более 253 символов. Если указан, префикс должен быть DNS-субдоменом — серией DNS-меток, разделённых точками (.), и он должен заканчиваться косой чертой (/).
- Сегмент имени является обязательным и должен содержать не более 63 символов. Он может включать буквенно-цифровые символы ([a-z0-9A-Z]), дефисы (-), подчеркивания (_) и точки (.), но должен начинаться и заканчиваться буквенно-цифровым символом.
Примечание
Значения аннотаций должны содержать не более 255 символов.Аннотации могут быть добавлены или изменены в любое время. Каждый ресурс может иметь несколько аннотаций.
key -> (строка)
value -> (строка)
namespace -> (строка)
Имя пространства Amazon EKS кластера. В Kubernetes пространства имён предоставляют механизм изоляции групп ресурсов в пределах одного кластера. Имена ресурсов должны быть уникальными в пределах пространства имён, но не во всех пространствах имён. Batch размещает под Batch Job в этом пространстве имён. Если этот параметр предоставлен, значение не может быть пустым или нулевым. Оно должно соответствовать следующим требованиям:
- Длина 1-63 символа
- Не может быть установлено на значение по умолчанию
- Не может начинаться с
kube - Должно соответствовать следующему регулярному выражению:
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Дополнительную информацию см. в разделе Пространства имён в документации Kubernetes. Это пространство имён может отличаться от kubernetesNamespace, установленного в среде вычислений EksConfiguration, но должно иметь одинаковые роли управления доступом на основе ролей (RBAC) со средой вычислений kubernetesNamespace. Для заданий с параллельной обработкой на нескольких узлах это значение должно быть одинаковым для всех диапазонов узлов.
Синтаксис JSON:
{
"podProperties": {
"containers": [
{
"name": "string",
"image": "string",
"command": ["string", ...],
"args": ["string", ...],
"env": [
{
"name": "string",
"value": "string"
}
...
],
"resources": {
"limits": {"string": "string"
...},
"requests": {"string": "string"
...}
}
}
...
],
"initContainers": [
{
"name": "string",
"image": "string",
"command": ["string", ...],
"args": ["string", ...],
"env": [
{
"name": "string",
"value": "string"
}
...
],
"resources": {
"limits": {"string": "string"
...},
"requests": {"string": "string"
...}
}
}
...
],
"metadata": {
"labels": {"string": "string"
...},
"annotations": {"string": "string"
...},
"namespace": "string"
}
}
}
--ecs-properties-override (структура)
Объект с свойствами, которые переопределяют значения по умолчанию для определения задания, может быть указан только для заданий, выполняемых на ресурсах Amazon ECS.
taskProperties -> (список)
Переопределения для определения задачи Amazon ECS для задания.
Примечание
В настоящее время этот объект ограничен одним элементом.(структура)
Объект, содержащий переопределения для определения задачи задания.
containers -> (список)
Переопределения для определения контейнера задания.
(структура)
Переопределения, которые должны быть отправлены в контейнер.
Сведения об использовании переопределений Batch при подключении источников событий к целевым объектам см. в разделе BatchContainerOverrides.
command -> (список)
Команда для отправки в контейнер, которая переопределяет командную строку по умолчанию из образа Docker или определения задания.
Примечание
Этот параметр не может содержать пустую строку.(строка)
environment -> (список)
Переменные среды, которые нужно отправить в контейнер. Вы можете добавить новые переменные среды, которые будут добавлены в контейнер при запуске, или переопределить существующие переменные среды из образа Docker или определения задания.
Примечание
Переменные среды не могут начинаться сAWS_BATCH. Эта конвенция именования зарезервирована для переменных, которые устанавливает Batch.(структура)
Объект пар «ключ-значение».
name -> (строка)
value -> (строка)
name -> (строка)
resourceRequirements -> (список)
Тип и количество ресурсов для назначения контейнеру. Это переопределяет настройки в определении задания. Поддерживаемые ресурсы включают в себя GPU , MEMORY и VCPU .
(структура)
Тип и количество ресурса для назначения контейнеру. Поддерживаемые ресурсы включают в себя GPU , MEMORY и VCPU .
value -> (строка)
Количество указанного ресурса для резервирования для контейнера. Значения зависят от указанного type.
Количество физических графических процессоров (GPU), которые нужно зарезервировать для контейнера. Убедитесь, что количество графических процессоров, зарезервированных для всех контейнеров в задании, не превышает количество доступных графических процессоров на вычислительном ресурсе, на котором запускается задание.
Примечание
Графические процессоры (GPU) недоступны для заданий, выполняемых на ресурсах Fargate.
type=”MEMORY”
Жесткий лимит памяти (в Мбайт) для контейнера. Этот параметр поддерживается для заданий, выполняемых на ресурсах Amazon EC2. Если контейнер пытается превысить указанный объем памяти, контейнер завершается. Этот параметр соответствует Memory в разделе «Создание контейнера» удаленного API Docker и параметру --memory для docker run. Для задания необходимо указать не менее 4 Мбайт памяти. Это обязательно, но может быть указано в нескольких местах для заданий параллельной обработки на нескольких узлах (MNP). Оно должно быть указано для каждого узла хотя бы один раз. Этот параметр соответствует Memory в разделе «Создание контейнера» удаленного API Docker и параметру --memory для docker run.
Примечание
Если вы пытаетесь максимизировать использование ресурсов, предоставляя заданиям максимальное количество памяти для определенного типа экземпляра, см. Управление памятью в Руководстве пользователя Batch.Для заданий, выполняемых на ресурсах Fargate, value — это жесткий лимит (в Мбайт) и должен соответствовать одному из поддерживаемых значений, а VCPU должны быть одним из поддерживаемых значений для этого значения памяти.
VCPU = 0.25
VCPU = 0.25 или 0.5
type=”VCPU”
Синтаксис JSON:
{
"taskProperties": [
{
"containers": [
{
"command": ["string", ...],
"environment": [
{
"name": "string",
"value": "string"
}
...
],
"name": "string",
"resourceRequirements": [
{
"value": "string",
"type": "GPU"|"VCPU"|"MEMORY"
}
...
]
}
...
]
}
...
]
}
--consumable-resource-properties-override (структура)
Объект, содержащий переопределения для потребляемых ресурсов задания.
consumableResourceList -> (список)
Список потребляемых ресурсов, необходимых заданию.
(структура)
Информация о потребляемом ресурсе, необходимом для выполнения задания.
consumableResource -> (строка)
quantity -> (целое число)
Упрощенный синтаксис:
consumableResourceList=[{consumableResource=string,quantity=long},{consumableResource=string,quantity=long}]
Синтаксис JSON:
{
"consumableResourceList": [
{
"consumableResource": "string",
"quantity": long
}
...
]
}
--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный, и будет использоваться содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для заданного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пейджер для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, подобные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для отправки задачи
В этом примере отправляется простая задача контейнера под названием example в очередь задач HighPriority.
Команда:
aws batch submit-job --job-name example --job-queue HighPriority --job-definition sleep60
Вывод:
{
"jobName": "example",
"jobId": "876da822-4198-45f2-a252-6cea32512ea8"
}
Вывод
jobArn -> (string)
jobName -> (string)
jobId -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
