你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CloudJob 类

Azure Batch作业。

继承

Model

CloudJob

构造函数

CloudJob(*, id: str = None, display_name: str = None, uses_task_dependencies: bool = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, previous_state=None, previous_state_transition_time=None, priority: int = None, allow_task_preemption: bool = None, max_parallel_tasks: int = -1, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, pool_info=None, on_all_tasks_complete=None, on_task_failure=None, network_configuration=None, metadata=None, execution_info=None, stats=None, **kwargs)

参数

id

str

必需

ID 是保留大小写且不区分大小写 (也就是说，帐户中可能没有两个 ID，这些 ID 仅因大小写) 而异。

display_name

str

必需

uses_task_dependencies

bool

必需

作业中的任务是否可以定义彼此的依赖关系。 默认值为 false。

url

str

必需

e_tag

str

必需

这是一个不透明的字符串。 可以使用它来检测作业是否在请求之间发生了更改。 具体而言，可以在更新作业时传递 ETag，以指定仅当其他人在此期间没有修改作业时所做的更改才生效。

last_modified

datetime

必需

这是作业级别数据（如作业状态或优先级）的最后一次更改。 它不考虑任务级别的更改，例如添加新任务或任务更改状态。

creation_time

datetime

必需

state

str 或 JobState

必需

作业的当前状态。 可能的值包括：“active”、“disableing”、“disabled”、“enableing”、“terminating”、“completed”、“删除”

state_transition_time

datetime

必需

previous_state

str 或 JobState

必需

作业的上一状态。 如果作业处于其初始活动状态，则不设置此属性。 可能的值包括：“active”、“disableing”、“disabled”、“enableing”、“terminating”、“completed”、“删除”

previous_state_transition_time

datetime

必需

如果作业处于其初始活动状态，则不设置此属性。

priority

int

必需

作业的优先级。 优先级值的范围为 -1000 到 1000，-1000 表示最低优先级，1000 表示最高优先级。 默认值为 0。

allow_task_preemption

bool

必需

此作业中的任务是否可以被其他高优先级作业抢占。 如果该值设置为 True，则提交到系统的其他高优先级作业将优先，并且能够从此作业重新排队任务。 使用更新作业 API 创建作业后，可以更新作业的 allowTaskPreemption。

max_parallel_tasks

int

必需

可为作业并行执行的最大任务数。 maxParallelTasks 的值必须为 -1 或大于 0（如果指定）。 如果未指定，默认值为 -1，这意味着一次可以运行的任务数没有限制。 使用更新作业 API 创建作业后，可以更新该作业的 maxParallelTask。 默认值：-1 。

constraints

JobConstraints

必需

作业的执行约束。

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

必需

当作业中的所有任务都处于已完成状态时，Batch 服务应采取的操作。 默认值为 noaction。 可能的值包括：“noAction”、“terminateJob”

on_task_failure

str 或 OnTaskFailure

必需

当作业中的任何任务失败时，Batch 服务应采取的操作。 如果存在 failureInfo，则任务被视为失败。 如果任务在重试计数耗尽后以非零退出代码完成，或者如果启动 Task 时出错（例如由于资源文件下载错误），则会设置 failureInfo。 默认值为 noaction。 可能的值包括：“noAction”、“performExitOptionsJobAction”

network_configuration

JobNetworkConfiguration

必需

作业的网络配置。

metadata

list[MetadataItem]

必需

Batch 服务不赋予元数据任何含义;它仅用于使用用户代码。

execution_info

JobExecutionInformation

必需

作业的执行信息。

stats

JobStatistics

必需

作业整个生存期的资源使用情况统计信息。 仅当使用包含“stats”属性的 expand 子句检索 CloudJob 时，才会填充此属性;否则为 null。 统计信息可能不会立即可用。 Batch 服务执行统计信息的定期汇总。 典型的延迟约为 30 分钟。

方法

as_dict	返回可以使用 json.dump 的 JSONify 的 dict。 高级用法可以选择使用回调作为参数： Key 是 Python 中使用的属性名称。 Attr_desc是元数据的一个听写。 当前包含具有 msrest 类型的“type”和包含 RestAPI 编码键的“key”。 值是此对象中的当前值。 返回的字符串将用于序列化密钥。 如果返回类型是列表，则这被视为分层结果听写。 请参阅此文件中的三个示例： attribute_transformer full_restapi_key_transformer last_restapi_key_transformer 如果需要 XML 序列化，可以传递 kwargs is_xml=True。
deserialize	使用 RestAPI 语法分析 str 并返回模型。
enable_additional_properties_sending
from_dict	使用给定的键提取程序分析 dict 返回一个模型。 默认情况下，请考虑密钥提取程序 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	返回将从此模型发送到 azure 的 JSON。 这是as_dict (full_restapi_key_transformer的别名 ，keep_readonly=False) 。 如果需要 XML 序列化，可以传递 kwargs is_xml=True。
validate	以递归方式验证此模型，并返回 ValidationError 列表。

as_dict

返回可以使用 json.dump 的 JSONify 的 dict。

高级用法可以选择使用回调作为参数：

Key 是 Python 中使用的属性名称。 Attr_desc是元数据的一个听写。 当前包含具有 msrest 类型的“type”和包含 RestAPI 编码键的“key”。 值是此对象中的当前值。

返回的字符串将用于序列化密钥。 如果返回类型是列表，则这被视为分层结果听写。

请参阅此文件中的三个示例：

• 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

返回

与 dict JSON 兼容的对象

返回类型

dict

deserialize

使用 RestAPI 语法分析 str 并返回模型。

deserialize(data, content_type=None)

参数

data

str

必需

使用 RestAPI 结构的 str。 默认情况下为 JSON。

content_type

str

默认值: None

默认情况下，如果 XML，则设置 application/xml。

返回

此模型的实例

例外

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

使用给定的键提取程序分析 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 结构的 dict

content_type

str

默认值: None

默认情况下，如果 XML，则设置 application/xml。

key_extractors

默认值: None

返回

此模型的实例

例外

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

返回将从此模型发送到 azure 的 JSON。

这是as_dict (full_restapi_key_transformer的别名 ，keep_readonly=False) 。

如果需要 XML 序列化，可以传递 kwargs is_xml=True。

serialize(keep_readonly=False, **kwargs)

参数

keep_readonly

bool

默认值: False

如果要序列化只读属性

返回

与 dict JSON 兼容的对象

返回类型

dict

validate

以递归方式验证此模型，并返回 ValidationError 列表。

validate()

返回

验证错误列表

返回类型

list