Spec-Zone.ru › AWS CLI v2

[ aws . batch ]

create-job-queue

Описание

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

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

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

Синтаксис

  create-job-queue
--job-queue-name <value>
[--state <value>]
[--scheduling-policy-arn <value>]
--priority <value>
--compute-environment-order <value>
[--tags <value>]
[--job-state-time-limit-actions <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-queue-name (строка)

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

--state (строка)

Состояние очереди задач. Если состояние очереди задач равно ENABLED, она может принимать задачи. Если состояние очереди задач равно DISABLED, новые задачи не могут быть добавлены в очередь, но задачи, уже находящиеся в очереди, могут завершиться.

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

  • ENABLED
  • DISABLED

--scheduling-policy-arn (строка)

Amazon Resource Name (ARN) политики планирования по принципу справедливого распределения. Очереди задач, не имеющие политики планирования по принципу справедливого распределения, планируются по модели «первый пришёл — первый обслужен» (FIFO). После того, как очередь задач получила политику планирования по принципу справедливого распределения, её можно заменить, но удалить нельзя.

Формат: ``aws:Partition :batch:Region :Account :scheduling-policy/Name `` .

Пример: aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy .

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

--priority (целое число)

Приоритет очереди задач. Очереди задач с более высоким приоритетом (или большим целым значением параметра priority) обрабатываются в первую очередь, если они связаны с одной и той же вычислительной средой. Приоритет определяется в порядке убывания. Например, очередь задач с приоритетом 10 получает предпочтение при планировании по сравнению с очередью задач с приоритетом 1. Все вычислительные среды должны быть либо EC2 (EC2 или SPOT), либо Fargate (FARGATE или FARGATE_SPOT); смешивание сред EC2 и Fargate недопустимо.

--compute-environment-order (список)

Набор вычислительных сред, сопоставленных с очередью задач, и их порядок относительно друг друга. Планировщик задач использует этот параметр для определения вычислительной среды, на которой будет выполняться конкретная задача. Вычислительные среды должны быть в состоянии VALID, прежде чем вы сможете связать их с очередью задач. Вы можете связать до трёх вычислительных сред с очередью задач. Все вычислительные среды должны быть либо EC2 (EC2 или SPOT), либо Fargate (FARGATE или FARGATE_SPOT); смешивание сред EC2 и Fargate недопустимо.

Примечание

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

(структура)

Порядок, в котором вычислительные среды проверяются для размещения задач в очереди. Вычислительные среды проверяются в порядке возрастания. Например, если две вычислительные среды связаны с очередью задач, вычислительная среда с меньшим значением целого числа порядка проверяется для размещения задач первой. Вычислительные среды должны быть в состоянии VALID, прежде чем вы сможете связать их с очередью задач. Все вычислительные среды должны быть либо EC2 (EC2 или SPOT), либо Fargate (FARGATE или FARGATE_SPOT); Amazon EC2 и Fargate вычислительные среды не могут быть смешаны.

Примечание

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

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

Порядок вычислительной среды. Вычислительные среды проверяются в порядке возрастания. Например, если две вычислительные среды связаны с очередью задач, вычислительная среда с меньшим значением целого числа order проверяется для размещения задач первой.

computeEnvironment -> (строка)

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

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

order=integer,computeEnvironment=string ...

Синтаксис JSON:

[
  {
    "order": integer,
    "computeEnvironment": "string"
  }
  ...
]

--tags (словарь)

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

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--job-state-time-limit-actions (список)

Набор действий, которые Batch выполняет для задач, которые остаются в начале очереди задач в указанном состоянии дольше определенного времени. Batch выполнит каждое действие после истечения maxTimeSeconds. (Примечание: минимальное значение для maxTimeSeconds — 600 (10 минут), а максимальное — 86 400 (24 часа)).

(структура)

Указывает действие, которое Batch предпримет после того, как задача останется в начале очереди в указанном состоянии дольше указанного времени.

reason -> (строка)

Причина для логирования действия.

state -> (строка)

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

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

Приблизительное время в секундах, которое должно пройти с задачей в указанном состоянии, прежде чем будет выполнено действие. Минимальное значение — 600 (10 минут), максимальное — 86 400 (24 часа).

action -> (строка)

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

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

reason=string,state=string,maxTimeSeconds=integer,action=string ...

Синтаксис JSON:

[
  {
    "reason": "string",
    "state": "RUNNABLE",
    "maxTimeSeconds": integer,
    "action": "CANCEL"
  }
  ...
]

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

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

Отключить вывод страниц cli.

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

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

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

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

Примеры

Примечание

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

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

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

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

Команда:

aws batch create-job-queue --cli-input-json file://<path_to_json_file>/LowPriority.json

Формат файла JSON:

{
  "jobQueueName": "LowPriority",
  "state": "ENABLED",
  "priority": 10,
  "computeEnvironmentOrder": [
    {
      "order": 1,
      "computeEnvironment": "M4Spot"
    }
  ]
}

Вывод:

{
    "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/LowPriority",
    "jobQueueName": "LowPriority"
}

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

В этом примере создается очередь задач с именем HighPriority, использующая вычислительное окружение C4OnDemand с порядком 1 и вычислительное окружение M4Spot с порядком 2. Планировщик сначала попытается разместить задачи в вычислительном окружении C4OnDemand.

Команда:

aws batch create-job-queue --cli-input-json file://<path_to_json_file>/HighPriority.json

Формат файла JSON:

{
  "jobQueueName": "HighPriority",
  "state": "ENABLED",
  "priority": 1,
  "computeEnvironmentOrder": [
    {
      "order": 1,
      "computeEnvironment": "C4OnDemand"
    },
    {
      "order": 2,
      "computeEnvironment": "M4Spot"
    }
  ]
}

Вывод:

{
    "jobQueueArn": "arn:aws:batch:us-east-1:012345678910:job-queue/HighPriority",
    "jobQueueName": "HighPriority"
}

Вывод

jobQueueName -> (строка)

Имя очереди задач.

jobQueueArn -> (строка)

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

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

Spec-Zone.ru

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