JobAddParameter Класс
Добавляемое задание пакетная служба Azure.
Все необходимые параметры должны быть заполнены для отправки в Azure.
- Наследование
-
JobAddParameter
Конструктор
JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=None, **kwargs)
Параметры
- id
- str
Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Идентификатор сохраняет регистр и не учитывает регистр (то есть у вас может не быть двух идентификаторов в учетной записи, которые отличаются только по регистру).
- display_name
- str
Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода длиной до 1024.
- priority
- int
Приоритет задания. Значения приоритета могут указываться в диапазоне от -1000 до 1000, где -1000 является самым низким приоритетом, а 1000 — самым высшим. Значение по умолчанию — 0.
- max_parallel_tasks
- int
Максимальное количество задач, которые могут выполняться параллельно для задания. Значение maxParallelTasks должно быть равно -1 или больше 0, если указано. Если не указано, значение по умолчанию — -1, что означает отсутствие ограничений на количество задач, которые можно выполнять одновременно. Вы можете обновить maxParallelTasks задания после его создания с помощью API задания обновления. Значение по умолчанию: -1 .
- allow_task_preemption
- bool
Можно ли вытеснять задачи в этом задании другими высокоприоритетными заданиями. Если задано значение True, другие высокоприоритетные задания, отправленные в систему, будут иметь приоритет и смогут повторно отправлять задачи из этого задания. Вы можете обновить allowTaskPreemption задания после его создания с помощью API задания обновления.
- job_manager_task
- JobManagerTask
Сведения о задаче диспетчера заданий, запускаемой при запуске задания. Если задание не указывает задачу диспетчера заданий, пользователь должен явно добавить задачи в задание. Если задание указывает задачу диспетчера заданий, пакетная служба создает задачу диспетчера заданий при создании задания и попытается запланировать задачу диспетчера заданий перед планированием других задач в задании. Типичная задача диспетчера заданий — контролировать и (или) отслеживать выполнение заданий, например путем принятия решения о выполнении дополнительных задач, определения времени завершения работы и т. д. (Однако задача диспетчера заданий не ограничивается этими действиями— это полноценная задача в системе и выполнение любых действий, необходимых для задания.) Например, задача диспетчера заданий может скачать файл, указанный в качестве параметра, проанализировать содержимое этого файла и отправить дополнительные задачи на основе этого содержимого.
- job_preparation_task
- JobPreparationTask
Задача подготовки задания. Если задание имеет задачу подготовки задания, пакетная служба выполнит задачу подготовки задания на узле перед запуском любых задач этого задания на этом вычислительном узле.
- job_release_task
- JobReleaseTask
Задача выпуска задания. Задача выпуска задания не может быть указана без указания задачи подготовки задания для задания. Пакетная служба выполняет задачу выпуска задания на узлах, на которых запущена задача подготовки задания. Основной целью задачи выпуска задания является отмена изменений на вычислительных узлах, внесенных задачей подготовки задания. Примеры действий включают удаление локальных файлов или завершение работы служб, которые были запущены в рамках подготовки задания.
- common_environment_settings
- list[EnvironmentSetting]
Отдельные задачи могут переопределить указанный здесь параметр среды, указав то же имя параметра с другим значением.
- pool_info
- PoolInformation
Обязательный. Пул, в котором пакетная служба выполняет задачи задания.
- on_all_tasks_complete
- str или OnAllTasksComplete
Действие, которое должна выполнять пакетная служба, если все задачи в задании находятся в состоянии завершения. Обратите внимание, что если задание не содержит задач, все задачи считаются завершенными. Поэтому этот параметр чаще всего используется с задачей диспетчера заданий; Если вы хотите использовать автоматическое завершение заданий без диспетчера заданий, сначала присвойте свойству onAllTasksComplete значение noaction и обновите свойства задания, чтобы задать для onAllTasksComplete значение terminatejob после завершения добавления задач. Значение по умолчанию — noaction. Возможные значения: "noAction", "terminateJob"
- on_task_failure
- str или OnTaskFailure
Действие, выполняеме пакетной службой при сбое любой задачи в задании. Задача считается неудачной, если имеет failureInfo. FailureInfo устанавливается, если задача завершается с ненулевым кодом выхода после исчерпания количества повторных попыток или если произошла ошибка при запуске задачи, например из-за ошибки загрузки файла ресурсов. Значение по умолчанию — noaction. Возможные значения: "noAction", "performExitOptionsJobAction"
- metadata
- list[MetadataItem]
Пакетная служба не присваивает метаданным никакого значения; он предназначен исключительно для использования пользовательского кода.
- uses_task_dependencies
- bool
Могут ли задачи в задании определять зависимости друг от друга. Значение по умолчанию — false.
Методы
as_dict |
Возвращает диктовку, которая может иметь значение JSONify с помощью json.dump. При дополнительном использовании можно использовать обратный вызов в качестве параметра: Ключ — это имя атрибута, используемого в Python. Attr_desc — это диктовка метаданных. В настоящее время содержит тип с типом msrest и key с ключом в кодировке RestAPI. Значение — это текущее значение в этом объекте. Возвращаемая строка будет использоваться для сериализации ключа. Если тип возвращаемого значения является списком, это считается иерархическим результирующим диктом. См. три примера в этом файле:
Если требуется сериализация 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
Возвращаемое значение
Объект, совместимый с JSON для диктовки
Возвращаемый тип
deserialize
Выполните синтаксический анализ str с помощью синтаксиса RestAPI и верните модель.
deserialize(data, content_type=None)
Параметры
- content_type
- str
JSON по умолчанию задайте значение application/xml, если XML.
Возвращаемое значение
Экземпляр этой модели
Исключения
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)
Параметры
- content_type
- str
JSON по умолчанию задайте значение application/xml, если XML.
- key_extractors
Возвращаемое значение
Экземпляр этой модели
Исключения
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
Если вы хотите сериализовать атрибуты только для чтения
Возвращаемое значение
Объект, совместимый с JSON для диктовки
Возвращаемый тип
validate
Рекурсивная проверка модели и возврат списка ValidationError.
validate()
Возвращаемое значение
Список ошибок проверки
Возвращаемый тип
Azure SDK for Python
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по