Поделиться через

az batch task

  • Ссылка

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

Команды

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

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

 Ядро ГА
az batch task delete

Удаляет задачу из указанного задания.

 Ядро ГА
az batch task file

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

 Ядро ГА
az batch task file delete

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

 Ядро ГА
az batch task file download

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

 Ядро ГА
az batch task file list

Выводит список файлов в каталоге задачи на вычислительном узле.

 Ядро ГА
az batch task file show

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

 Ядро ГА
az batch task list

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

 Ядро ГА
az batch task reactivate

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

 Ядро ГА
az batch task reset

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

 Ядро ГА
az batch task show

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

 Ядро ГА
az batch task stop

Завершает указанную задачу.

 Ядро ГА
az batch task subtask

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

 Ядро ГА
az batch task subtask list

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

 Ядро ГА

az batch task create

Изменить

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

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--task-id]

Примеры

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

az batch task create --task-id task1 --job-id job1 --command-line "sleep 60"

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

--job-id

Идентификатор задания, содержащего задачу.

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

--account-endpoint

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

--account-key

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

--account-name

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

--affinity-id

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

--application-package-references

Разделенный пробелами список идентификаторов, указывающий установленные пакеты приложений. Идентификаторы приложений с разделительным пространством с необязательной версией в формате id[#version].

--command-line

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

--environment-settings

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

--json-file

Файл, содержащий задачи для создания в формате JSON(отформатированный для сопоставления текста запроса REST API). При отправке нескольких задач принимает массив задач или taskAddCollectionParamater. Если этот параметр указан, все остальные параметры игнорируются.

--max-task-retry-count

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

--max-wall-clock-time

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

--resource-files

Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Ссылки на ресурсы, разделенные пробелами в формате filename=httpurl, при этом httpurl является любым URL-адресом HTTP с общедоступным доступом или URL-адресом SAS с доступом на чтение.

--retention-time

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

--task-id

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

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

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

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task delete

Изменить

Удаляет задачу из указанного задания.

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

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

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

--job-id

Идентификатор задания, из которого необходимо удалить задачу. Обязательно.

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

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

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

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

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task list

Изменить

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

Сведения о задачах с несколькими экземплярами, например affinityId, executionInfo и nodeInfo, относятся к основной задаче. Используйте API подзадач списка для получения сведений о подзадачах.

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

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

--job-id

Идентификатор задания. Обязательно.

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

--account-endpoint

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

--account-key

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

--account-name

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

--expand

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

--filter

Предложение OData $filter. Дополнительные сведения о создании этого фильтра см. в https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--select

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

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

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

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task reactivate

Изменить

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

Повторная активация делает задачу доступной для повторной повторной отправки до максимального количества повторных попыток. Состояние задачи изменяется на активное. Так как задача больше не находится в состоянии завершения, все предыдущие сведения о выходе или сбое больше не доступны после повторной активации. Каждый раз при повторной активации задачи его количество повторных попыток сбрасывается до 0. Повторная активация завершится сбоем для задач, которые не завершены или которые ранее успешно завершены (с кодом выхода 0). Кроме того, он завершится ошибкой, если задание завершено (или завершается или удаляется).

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

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

--job-id

Идентификатор задания, содержащего задачу. Обязательно.

--task-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
Default value: json
--query

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task reset

Изменить

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

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]

Примеры

Задайте максимальное число повторных попыток 3 и сбросьте другие свойства по умолчанию

az batch task reset --task-id task1 --job-id job1 --max-task-retry-count 3

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

--job-id

Идентификатор задания, содержащего задачу.

--task-id

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

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

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--json-file

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

--max-task-retry-count

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

--max-wall-clock-time

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

--retention-time

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

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

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

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task show

Изменить

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

Сведения о задачах с несколькими экземплярами, например affinityId, executionInfo и nodeInfo, относятся к основной задаче. Используйте API подзадач списка для получения сведений о подзадачах.

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

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

--job-id

Идентификатор задания, содержащего задачу. Обязательно.

--task-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
Default value: json
--query

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az batch task stop

Изменить

Завершает указанную задачу.

После завершения задачи он перемещается в состояние завершения. Для задач с несколькими экземплярами операция завершения задачи применяется синхронно к основной задаче; Затем подзадачи завершаются асинхронно в фоновом режиме.

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

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

--job-id

Идентификатор задания, содержащего задачу. Обязательно.

--task-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
Default value: json
--query

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.