az batch job

Примечание.

Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.

Управление заданиями пакетной службы.

Команды

Имя Описание Тип Состояние
az batch job create

Добавьте задание в учетную запись пакетной службы.

Основные сведения Общедоступная версия
az batch job create (azure-batch-cli-extensions Расширение)

Добавьте задание и связанные задачи в учетную запись пакетной службы.

Расширение Общедоступная версия
az batch job delete

Удаляет задание.

Основные сведения Общедоступная версия
az batch job disable

Отключает указанное задание, предотвращая выполнение новых задач.

Основные сведения Общедоступная версия
az batch job enable

Включает указанное задание, позволяя выполнять новые задачи.

Основные сведения Общедоступная версия
az batch job list

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

Основные сведения Общедоступная версия
az batch job prep-release-status

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

Основные сведения Общедоступная версия
az batch job prep-release-status list

Выводит состояние выполнения задачи подготовки задания и выпуска задания для указанного задания на вычислительных узлах, где выполняется задание.

Основные сведения Общедоступная версия
az batch job reset

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

Основные сведения Общедоступная версия
az batch job set

Обновите свойства задания пакетной службы. Обновление свойства в подгруппе приведет к сбросу неопределенных свойств этой группы.

Основные сведения Общедоступная версия
az batch job show

Возвращает сведения об указанном задании.

Основные сведения Общедоступная версия
az batch job stop

Остановите выполняемое пакетное задание.

Основные сведения Общедоступная версия
az batch job task-counts

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

Основные сведения Общедоступная версия
az batch job task-counts show

Возвращает количество задач для указанного задания.

Основные сведения Общедоступная версия

az batch job create

Добавьте задание в учетную запись пакетной службы.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--allow-task-preemption

Можно ли выполнять задачи в этом задании с высоким приоритетом. Если для значения задано значение True, другие задания с высоким приоритетом, отправленные в систему, будут иметь приоритет и смогут перезапускать задачи из этого задания. После создания задания с помощью API задания обновления можно обновить allowTaskPreemption. Значение True, если флаг присутствует.

--id

Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Идентификатор является сохранением регистра и не учитывает регистр (т. е. у вас не может быть двух идентификаторов в учетной записи, которые отличаются только по регистру).

--job-manager-task-command-line

Обязательный. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать переменную предоставленной среды пакетной службы (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--job-manager-task-environment-settings

Разделенные пробелами значения в формате key=value.

--job-manager-task-id

Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и подчеркивания, и не может содержать более 64 символов.

--job-manager-task-resource-files

Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Существует максимальный размер списка файлов ресурсов. При превышении максимального размера запрос завершится ошибкой, и код ошибки ответа будет RequestEntityTooLarge. В этом случае коллекция ResourceFiles должна быть уменьшена. Это можно сделать с помощью ZIP-файлов, пакетов приложений или контейнеров Docker. Ссылки на ресурсы, разделенные пробелами, в формате filename=httpurl.

--job-max-task-retry-count

Максимальное количество повторных попыток каждой задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение определяет количество повторных попыток. Пакетная служба попытается выполнить каждую задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачи. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачи без ограничения. Значение по умолчанию — 0 (без повторных попыток).

--job-max-wall-clock-time

Если задание не завершается в течение периода времени, пакетная служба завершает ее и все задачи, которые по-прежнему выполняются. В этом случае причиной завершения будет MaxWallClockTimeExpiry. Если это свойство не указано, время выполнения задания не ограничено. Ожидаемый формат — это длительность ISO-8601.

--json-file

Файл, содержащий спецификацию задания в ФОРМАТЕ JSON (отформатированный для соответствия соответствующему тексту REST API). Если этот параметр указан, все аргументы задания игнорируются.

--max-parallel-tasks

Максимальное количество задач, которые могут выполняться параллельно для задания. Значение maxParallelTasks должно быть равно -1 или больше 0, если указано. Если значение по умолчанию не указано, значение по умолчанию равно -1, что означает, что количество задач, которые могут выполняться одновременно, не ограничено. После создания задания с помощью API задания обновления можно обновить maxParallelTasks. Значение по умолчанию: -1.

--metadata

Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода. Разделенные пробелами значения в формате key=value.

--pool-id

Идентификатор существующего пула. Все задачи задания будут выполняться в указанном пуле.

--priority

Приоритет задания. Значения приоритета могут варьироваться от -1000 до 1000, при этом значение -1000 является самым низким приоритетом и 1000 является самым высоким приоритетом. Значение по умолчанию равно 0.

--required-slots

Количество слотов планирования, которые требуется выполнить задаче. Значение по умолчанию — 1. Задача может выполняться только на вычислительном узле, если узел имеет достаточно свободных слотов планирования. Для задач с несколькими экземплярами это свойство не поддерживается и не должно быть указано.

--uses-task-dependencies

Могут ли задачи в задании определять зависимости друг от друга. Значение по умолчанию — false. Значение True, если флаг присутствует.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job create (azure-batch-cli-extensions Расширение)

Добавьте задание и связанные задачи в учетную запись пакетной службы.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--parameters]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--resource-group]
                    [--template]
                    [--uses-task-dependencies]

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--allow-task-preemption

Можно ли выполнять задачи в этом задании с высоким приоритетом. Если для значения задано значение True, другие задания с высоким приоритетом, отправленные в систему, будут иметь приоритет и смогут перезапускать задачи из этого задания. После создания задания с помощью API задания обновления можно обновить allowTaskPreemption.

--id

Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Идентификатор является сохранением регистра и не учитывает регистр (т. е. у вас не может быть двух идентификаторов в учетной записи, которые отличаются только по регистру).

--job-manager-task-command-line

Командная строка задачи Диспетчера заданий. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux.

--job-manager-task-environment-settings

Список параметров переменной среды для задачи Диспетчера заданий. Разделенные пробелами значения в формате key=value.

--job-manager-task-id

Строка, которая однозначно идентифицирует задачу диспетчера заданий в задании. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов.

--job-manager-task-resource-files

Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на разделенные пробелами ресурсы в формате filename=httpurl.

--job-max-task-retry-count

Максимальное количество повторных попыток каждой задачи. Пакетная служба пытается выполнить задачу повторно, если ее код выхода имеет ненулевое значение. Обратите внимание, что это значение определяет количество повторных попыток. Пакетная служба попытается выполнить каждую задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторных). Если максимальное число повторных попыток равно 0, пакетная служба не пытается выполнить задачи повторно. Если максимальное число повторных попыток равно –1, пакетная служба может повторять попытки сколько угодно. Значение по умолчанию — 0 (без повторных попыток).

--job-max-wall-clock-time

Максимальное время выполнения задания, измеряемое с момента создания задания. Если задание не завершается в течение срока, пакетная служба завершает ее и все задачи, которые по-прежнему выполняются. В этом случае причиной завершения будет MaxWallClockTimeExpiry. Если это свойство не указано, время выполнения задания не ограничено. Ожидаемый формат — это длительность ISO-8601.

--json-file

Файл, содержащий спецификацию задания в ФОРМАТЕ JSON (отформатированный для соответствия соответствующему тексту REST API). Если этот параметр указан, все аргументы задания игнорируются.

--max-parallel-tasks

Максимальное количество задач, которые могут выполняться параллельно для задания. Значение maxParallelTasks должно быть равно -1 или больше 0, если указано. Если значение по умолчанию не указано, значение по умолчанию равно -1, что означает, что количество задач, которые могут выполняться одновременно, не ограничено. После создания задания с помощью API задания обновления можно обновить maxParallelTasks. Значение по умолчанию: -1.

--metadata

Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода.

--parameters

Значения параметров для файла шаблона json пакетного задания. Можно использовать только с --template.

--pool-id

Идентификатор существующего пула. Все задачи задания будут выполняться в указанном пуле.

--priority

Приоритет задания. Значения приоритета могут варьироваться от -1000 до 1000, при этом значение -1000 является самым низким приоритетом и 1000 является самым высоким приоритетом. Значение по умолчанию равно 0.

--required-slots

Количество слотов планирования, которые требуется выполнить задаче. Значение по умолчанию — 1. Задача может выполняться только на вычислительном узле, если узел имеет достаточно свободных слотов планирования. Для задач с несколькими экземплярами это свойство не поддерживается и не должно быть указано.

--resource-group

Группа ресурсов учетной записи пакетной службы.

--template

Файл шаблона json пакетного задания. Если этот параметр указан, все остальные параметры игнорируются.

--uses-task-dependencies

Флаг, определяющий, будет ли это задание использовать задачи с зависимостями. Значение True, если флаг присутствует.

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job delete

Удаляет задание.

При удалении задания также удаляются все задачи, которые являются частью этого задания, и все статистические данные задания. Это также переопределяет период хранения данных задачи; То есть, если задание содержит задачи, которые по-прежнему хранятся на вычислительных узлах, службы пакетной службы удаляют рабочие каталоги задач и все их содержимое. При получении запроса на удаление задания служба пакетной службы устанавливает задание в состояние удаления. Все операции обновления в задании, которое находится в состоянии удаления, завершаются сбоем с кодом состояния 409 (конфликт) с дополнительными сведениями, указывающими на удаление задания.

az batch job delete --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--yes]

Обязательные параметры

--job-id

Идентификатор удаленного задания.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

--yes -y

Не запрашивать подтверждение.

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job disable

Отключает указанное задание, предотвращая выполнение новых задач.

Пакетная служба немедленно перемещает задание в состояние отключения. Затем пакет использует параметр disableTasks, чтобы определить, что делать с текущими задачами задания. Задание остается в состоянии отключения до завершения операции отключения, и все задачи будут рассмотрены в соответствии с параметром disableTasks; Затем задание перемещается в отключенное состояние. Новые задачи не запускаются в задании, пока не вернется к активному состоянию. Если попытаться отключить задание, которое находится в любом состоянии, отличном от активного, отключения или отключения, запрос завершается ошибкой с кодом состояния 409.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]

Обязательные параметры

--job-id

Идентификатор задания, отключаемого.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--disable-tasks

Возможные значения включают: "requeue", "terminate", "wait".

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job enable

Включает указанное задание, позволяя выполнять новые задачи.

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

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

Обязательные параметры

--job-id

Идентификатор включенного задания.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job list

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

az batch job list [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--filter]
                  [--job-schedule-id]
                  [--select]

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--expand

Предложение OData $expand.

--filter

Предложение OData $filter.

--job-schedule-id

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

--select

Предложение OData $select.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job reset

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

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Обязательные параметры

--job-id

Идентификатор задания, свойства которого необходимо обновить.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--allow-task-preemption

Можно ли выполнять задачи в этом задании с высоким приоритетом. Если для значения задано значение True, другие задания с высоким приоритетом, отправленные в систему, будут иметь приоритет и смогут перезапускать задачи из этого задания. После создания задания с помощью API задания обновления можно обновить allowTaskPreemption. Значение True, если флаг присутствует.

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

--job-max-task-retry-count

Максимальное количество повторных попыток каждой задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение определяет количество повторных попыток. Пакетная служба попытается выполнить каждую задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачи. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачи без ограничения. Значение по умолчанию — 0 (без повторных попыток).

--job-max-wall-clock-time

Если задание не завершается в течение периода времени, пакетная служба завершает ее и все задачи, которые по-прежнему выполняются. В этом случае причиной завершения будет MaxWallClockTimeExpiry. Если это свойство не указано, время выполнения задания не ограничено. Ожидаемый формат — это длительность ISO-8601.

--json-file

Файл, содержащий спецификацию параметра обновления задания в ФОРМАТЕ JSON (отформатированный для соответствия соответствующему тексту REST API). Если этот параметр указан, все аргументы задания игнорируются.

--max-parallel-tasks

Максимальное количество задач, которые могут выполняться параллельно для задания. Значение maxParallelTasks должно быть равно -1 или больше 0, если указано. Если значение по умолчанию не указано, значение по умолчанию равно -1, что означает, что количество задач, которые могут выполняться одновременно, не ограничено. После создания задания с помощью API задания обновления можно обновить maxParallelTasks. Значение по умолчанию: -1.

--metadata

Если опущено, оно принимает значение по умолчанию пустого списка; в действительности все существующие метаданные удаляются. Разделенные пробелами значения в формате key=value.

--on-all-tasks-complete

Действие пакетной службы должно выполняться, когда все задачи в задании находятся в состоянии завершения. Если опущено, поведение завершения имеет значение noaction. Если текущее значение завершается, это ошибка, так как поведение завершения задания может не быть изменено с завершения задания на noaction. Вы не можете изменить значение с завершения задания на noaction , т. е. после автоматического завершения задания вы не можете отключить его снова. При попытке сделать это, запрос завершается ошибкой, и пакетная служба возвращает код состояния 400 (недопустимый запрос) и ответ на ошибку "недопустимое значение свойства". Если этот элемент не указан в запросе PUT, он эквивалентен передаче noaction. Это ошибка, если текущее значение завершает работу.

допустимые значения: noaction, terminatejob
--pool-id

Идентификатор существующего пула. Все задачи задания будут выполняться в указанном пуле.

--priority

Приоритет задания. Значения приоритета могут варьироваться от -1000 до 1000, при этом значение -1000 является самым низким приоритетом и 1000 является самым высоким приоритетом. Если опущено, оно имеет значение по умолчанию 0.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job set

Обновите свойства задания пакетной службы. Обновление свойства в подгруппе приведет к сбросу неопределенных свойств этой группы.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Обязательные параметры

--job-id

Идентификатор задания, свойства которого необходимо обновить.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--allow-task-preemption

Можно ли выполнять задачи в этом задании с высоким приоритетом. Если для значения задано значение True, другие задания с высоким приоритетом, отправленные в систему, будут иметь приоритет и смогут перезапускать задачи из этого задания. После создания задания с помощью API задания обновления можно обновить allowTaskPreemption. Укажите значение true или false, чтобы обновить свойство.

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

--job-max-task-retry-count

Максимальное количество повторных попыток каждой задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение определяет количество повторных попыток. Пакетная служба попытается выполнить каждую задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачи. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачи без ограничения. Значение по умолчанию — 0 (без повторных попыток).

--job-max-wall-clock-time

Если задание не завершается в течение периода времени, пакетная служба завершает ее и все задачи, которые по-прежнему выполняются. В этом случае причиной завершения будет MaxWallClockTimeExpiry. Если это свойство не указано, время выполнения задания не ограничено. Ожидаемый формат — это длительность ISO-8601.

--json-file

Файл, содержащий спецификацию параметра исправления задания в ФОРМАТЕ JSON (отформатированный в соответствии с соответствующим текстом REST API). Если этот параметр указан, все аргументы задания игнорируются.

--max-parallel-tasks

Максимальное количество задач, которые могут выполняться параллельно для задания. Значение maxParallelTasks должно быть равно -1 или больше 0, если указано. Если значение по умолчанию не указано, значение по умолчанию равно -1, что означает, что количество задач, которые могут выполняться одновременно, не ограничено. После создания задания с помощью API задания обновления можно обновить maxParallelTasks.

--metadata

Если не указано, существующие метаданные задания остаются неизменными. Разделенные пробелами значения в формате key=value.

--on-all-tasks-complete

Действие пакетной службы должно выполняться, когда все задачи в задании находятся в состоянии завершения. Если опущено, поведение завершения остается неизменным. Вы не можете изменить значение с завершения задания на noaction , т. е. после автоматического завершения задания вы не можете отключить его снова. При попытке сделать это запрос завершается ошибкой с сообщением об ошибке "недопустимое значение свойства"; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).

допустимые значения: noaction, terminatejob
--pool-id

Идентификатор существующего пула. Все задачи задания будут выполняться в указанном пуле.

--priority

Приоритет задания. Значения приоритета могут варьироваться от -1000 до 1000, при этом значение -1000 является самым низким приоритетом и 1000 является самым высоким приоритетом. Если опущено, приоритет задания остается неизменным.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job show

Возвращает сведения об указанном задании.

az batch job show --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--select]

Обязательные параметры

--job-id

Идентификатор задания.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--expand

Предложение OData $expand.

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

--select

Предложение OData $select.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az batch job stop

Остановите выполняемое пакетное задание.

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

az batch job stop --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--terminate-reason]

Обязательные параметры

--job-id

Идентификатор завершения задания.

Необязательные параметры

--account-endpoint

Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.

--account-key

Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--if-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.

--if-modified-since

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

--if-none-match

Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.

--if-unmodified-since

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

--terminate-reason

Причина завершения.

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.