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

JobPatchParameter 类

  • 参考

要对作业进行的更改集。

继承
Model
JobPatchParameter

构造函数

JobPatchParameter(*, priority: int = None, max_parallel_tasks: int = None, allow_task_preemption: bool = None, on_all_tasks_complete=None, constraints=None, pool_info=None, metadata=None, **kwargs)

参数

priority
int
必需

作业的优先级。 优先级值的范围为 -1000 到 1000，-1000 表示最低优先级，1000 表示最高优先级。 如果省略，则作业的优先级保持不变。

max_parallel_tasks
int
必需

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

allow_task_preemption
bool
必需

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

on_all_tasks_complete
str 或 OnAllTasksComplete
必需

当作业中的所有任务都处于已完成状态时，Batch 服务应执行的操作。 如果省略，则完成行为保持不变。 不能将值从 terminatejob 更改为 noaction - 也就是说，一旦启用了自动作业终止，便无法再次关闭它。 如果尝试执行此操作，请求会失败，并出现“无效的属性值”错误响应;如果直接调用 REST API，则 HTTP 状态代码为 400 (错误请求) 。 可能的值包括：“noAction”、“terminateJob”

constraints
JobConstraints
必需

作业的执行约束。 如果省略，现有执行约束保持不变。

pool_info
PoolInformation
必需

Batch 服务在其中运行作业的任务的池。 仅当禁用作业时，才能更改作业的池。 如果包含 poolInfo 元素且作业未禁用，则修补作业调用将失败。 如果在 poolInfo 中指定 autoPoolSpecification，则只能更新 autoPoolSpecification 的 keepAlive 属性，并且仅当 autoPoolSpecification 的 poolLifetimeOption 为 Job (其他作业属性可以更新为正常) 。 如果省略，作业将继续在其当前池上运行。

metadata
list[MetadataItem]
必需

如果省略，现有作业元数据保持不变。

方法

as_dict

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

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

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

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

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

  • 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”。 Value 是此 对象中的当前值。

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

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

  • 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