JobReleaseTask Класс

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

Задача "Освобождение задания" выполняется по завершении задания из-за одного из следующих факторов: пользователь вызывает API завершения задания или API удаления задания, когда задание по-прежнему активно, достигается максимальное ограничение времени на стенные часы задания, задание по-прежнему активно или задача диспетчера заданий завершена, и задание настраивается для завершения после завершения диспетчера заданий. Задача выпуска задания выполняется на каждом узле, где выполняются задачи задания, а задача подготовки задания выполняется и завершается. Если после выполнения задачи подготовки задания повторно создается создание образа узла, а задание завершается без дальнейших задач задания, выполняющегося на этом узле (и, следовательно, задача подготовки задания не выполняется повторно), то задача выпуска задания не будет выполняться на этом вычислительном узле. Если узел перезагружается во время выполнения задачи выпуска задания, задача выпуска задания снова запускается при запуске вычислительного узла. Задание не помечается как завершенное, пока не будут завершены все задачи выпуска задания. Задача выпуска задания выполняется в фоновом режиме. Он не занимает слот планирования; то есть он не учитывается в пределе taskSlotsPerNode, заданном в пуле.

Все необходимые параметры должны быть заполнены для отправки в Azure.

Наследование
JobReleaseTask

Конструктор

JobReleaseTask(*, command_line: str, id: str = None, container_settings=None, resource_files=None, environment_settings=None, max_wall_clock_time=None, retention_time=None, user_identity=None, **kwargs)

Параметры

id
str
Обязательно

Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Если это свойство не указано, пакетная служба назначает значение по умолчанию jobrelease. Никакая другая задача в задании не может иметь того же идентификатора, что и задача выпуска задания. При попытке отправить задачу с тем же идентификатором пакетная служба отклоняет запрос с кодом ошибки TaskIdSameAsJobReleaseTask; Если вы вызываете REST API напрямую, код состояния HTTP — 409 (конфликт).

command_line
str
Обязательно

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

container_settings
TaskContainerSettings
Обязательно

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

resource_files
list[ResourceFile]
Обязательно

Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи.

environment_settings
list[EnvironmentSetting]
Обязательно
max_wall_clock_time
<xref:timedelta>
Обязательно
retention_time
<xref:timedelta>
Обязательно

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

user_identity
UserIdentity
Обязательно

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

Методы

as_dict

Возвращает диктовку, которая может иметь значение JSONify с помощью json.dump.

При дополнительном использовании можно использовать обратный вызов в качестве параметра:

Ключ — это имя атрибута, используемого в Python. Attr_desc — это диктовка метаданных. В настоящее время содержит тип с типом msrest и key с ключом в кодировке RestAPI. Значение — это текущее значение в этом объекте.

Возвращаемая строка будет использоваться для сериализации ключа. Если тип возвращаемого значения является списком, это считается иерархическим результирующим диктом.

См. три примера в этом файле:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Если требуется сериализация XML, можно передать kwargs is_xml=True.

deserialize

Выполните синтаксический анализ str с помощью синтаксиса RestAPI и верните модель.

enable_additional_properties_sending
from_dict

Синтаксический анализ диктовки с помощью заданного средства извлечения ключей возвращает модель.

По умолчанию рекомендуется использовать средства извлечения ключей (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor и last_rest_key_case_insensitive_extractor).

is_xml_model
serialize

Возвращает json, который будет отправлен в Azure из этой модели.

Это псевдоним для as_dict(full_restapi_key_transformer, keep_readonly=False).

Если требуется сериализация XML, можно передать kwargs is_xml=True.

validate

Рекурсивная проверка модели и возврат списка ValidationError.

as_dict

Возвращает диктовку, которая может иметь значение JSONify с помощью json.dump.

При дополнительном использовании можно использовать обратный вызов в качестве параметра:

Ключ — это имя атрибута, используемого в Python. Attr_desc — это диктовка метаданных. В настоящее время содержит тип с типом msrest и key с ключом в кодировке RestAPI. Значение — это текущее значение в этом объекте.

Возвращаемая строка будет использоваться для сериализации ключа. Если тип возвращаемого значения является списком, это считается иерархическим результирующим диктом.

См. три примера в этом файле:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Если требуется сериализация XML, можно передать kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Параметры

key_transformer
<xref:function>

Функция преобразователя ключей.

keep_readonly
значение по умолчанию: True

Возвращаемое значение

Объект, совместимый с JSON для диктовки

Возвращаемый тип

deserialize

Выполните синтаксический анализ str с помощью синтаксиса RestAPI и верните модель.

deserialize(data, content_type=None)

Параметры

data
str
Обязательно

Str, использующий структуру RestAPI. JSON по умолчанию.

content_type
str
значение по умолчанию: None

JSON по умолчанию задайте значение application/xml, если XML.

Возвращаемое значение

Экземпляр этой модели

Исключения

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Синтаксический анализ диктовки с помощью заданного средства извлечения ключей возвращает модель.

По умолчанию рекомендуется использовать средства извлечения ключей (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor и last_rest_key_case_insensitive_extractor).

from_dict(data, key_extractors=None, content_type=None)

Параметры

data
dict
Обязательно

Диктовка, использующий структуру RestAPI

content_type
str
значение по умолчанию: None

JSON по умолчанию задайте значение application/xml, если XML.

key_extractors
значение по умолчанию: None

Возвращаемое значение

Экземпляр этой модели

Исключения

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Возвращает json, который будет отправлен в Azure из этой модели.

Это псевдоним для as_dict(full_restapi_key_transformer, keep_readonly=False).

Если требуется сериализация XML, можно передать kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Параметры

keep_readonly
bool
значение по умолчанию: False

Если вы хотите сериализовать атрибуты только для чтения

Возвращаемое значение

Объект, совместимый с JSON для диктовки

Возвращаемый тип

validate

Рекурсивная проверка модели и возврат списка ValidationError.

validate()

Возвращаемое значение

Список ошибок проверки

Возвращаемый тип