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]

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

--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
значение по умолчанию: 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

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

значение по умолчанию: 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 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://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.

--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 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
значение по умолчанию: 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]

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

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

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

--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
значение по умолчанию: 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
значение по умолчанию: 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
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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