BatchJobSpecificationOutput interface

包:

@azure-rest/batch

指定要按计划创建的作业的详细信息。

属性

allowTaskPreemption	此作业中的任务是否可以被其他高优先级作业抢占。 （默认情况下，此属性不可用。请联系支持人员了解更多信息）如果该值设置为 True，则提交到系统的其他高优先级作业将优先，并且能够从此作业重新排队任务。 使用更新作业 API 创建作业后，可以更新作业的 allowTaskPreemption。
commonEnvironmentSettings	常见环境变量设置的列表。 这些环境变量针对在此计划下创建的作业中的所有任务（包括作业管理器、作业准备和作业发布任务）设置。 单个任务可以通过使用不同的值指定相同的设置名称来替代此处指定的环境设置。
constraints	在此计划下创建的作业的执行约束。
displayName	在此计划下创建的作业的显示名称。 该名称不是唯一的，可以包含最大长度为 1024 的任何 Unicode 字符。
jobManagerTask	在此计划下启动作业时要启动的作业管理器任务的详细信息。 如果作业未指定作业管理器任务，则用户必须使用任务 API 显式将任务添加到作业。 如果作业确实指定了作业管理器任务，Batch 服务会在创建作业时创建作业管理器任务，并将尝试在作业中计划其他任务之前计划作业管理器任务。
jobPreparationTask	根据此计划创建的作业的作业准备任务。 如果作业具有作业准备任务，批处理服务将在节点上运行作业准备任务，然后再在该计算节点上启动该作业的任何任务。
jobReleaseTask	根据此计划创建的作业的作业发布任务。 作业发布任务的主要用途是撤消作业准备任务对节点所做的更改。 示例活动包括删除本地文件或关闭在作业准备过程中启动的服务。 如果不同时指定作业的作业准备任务，则无法指定作业发布任务。 Batch 服务在运行作业准备任务的计算节点上运行作业发布任务。
maxParallelTasks	可为作业并行执行的最大任务数。 （默认情况下，此属性不可用。请联系支持人员了解更多信息）maxParallelTasks 的值必须为 -1 或大于 0（如果指定）。 如果未指定，则默认值为 -1，这意味着一次可以运行的任务数没有限制。 使用更新作业 API 创建作业后，可以更新作业的 maxParallelTasks。
metadata	与此计划下创建的每个作业关联的名称/值对列表作为元数据。 Batch 服务不向元数据分配任何含义;它仅用于使用用户代码。
networkConfiguration	（默认情况下，此属性不可用。请联系支持人员了解更多信息）作业的网络配置。
onAllTasksComplete	当在此计划下创建的作业中的所有任务都处于已完成状态时，Batch 服务应执行的操作。 请注意，如果作业不包含任何任务，则所有任务都被视为已完成。 因此，此选项最常用于作业管理器任务;如果要在没有作业管理器的情况下使用自动作业终止，则应最初将 OnAllTasksComplete 设置为 noaction，并将作业属性更新为在完成添加任务后将 OnAllTasksComplete 设置为 terminatejob。 默认值为 noaction。 可能的值：“noaction”、“terminatejob”
onTaskFailure	Batch 服务在此计划下创建的作业中失败时，批处理服务应执行的操作。 如果任务失败，则任务被视为失败（如果有 failureInfo）。 如果任务在耗尽重试计数后使用非零退出代码完成，或者启动任务时出错（例如由于资源文件下载错误），则设置 failureInfo。 默认值为 noaction。 可能的值：“noaction”、“performexitoptionsjobaction”
poolInfo	Batch 服务运行在此计划下创建的作业任务的池。
priority	在此计划下创建的作业的优先级。 优先级值的范围可以是 -1000 到 1000，-1000 是最低优先级，1000 是最高优先级。 默认值为 0。 此优先级用作作业计划下的所有作业的默认值。 使用更新作业 API 创建作业后，可以更新作业的优先级。
usesTaskDependencies	作业中的任务是否可以定义彼此的依赖关系。 默认值为 false。

属性详细信息

allowTaskPreemption

此作业中的任务是否可以被其他高优先级作业抢占。 （默认情况下，此属性不可用。请联系支持人员了解更多信息）如果该值设置为 True，则提交到系统的其他高优先级作业将优先，并且能够从此作业重新排队任务。 使用更新作业 API 创建作业后，可以更新作业的 allowTaskPreemption。

allowTaskPreemption?: boolean

属性值

boolean

commonEnvironmentSettings

常见环境变量设置的列表。 这些环境变量针对在此计划下创建的作业中的所有任务（包括作业管理器、作业准备和作业发布任务）设置。 单个任务可以通过使用不同的值指定相同的设置名称来替代此处指定的环境设置。

commonEnvironmentSettings?: EnvironmentSettingOutput[]

属性值

EnvironmentSettingOutput[]

constraints

在此计划下创建的作业的执行约束。

constraints?: BatchJobConstraintsOutput

属性值

BatchJobConstraintsOutput

displayName

在此计划下创建的作业的显示名称。 该名称不是唯一的，可以包含最大长度为 1024 的任何 Unicode 字符。

displayName?: string

属性值

string

jobManagerTask

在此计划下启动作业时要启动的作业管理器任务的详细信息。 如果作业未指定作业管理器任务，则用户必须使用任务 API 显式将任务添加到作业。 如果作业确实指定了作业管理器任务，Batch 服务会在创建作业时创建作业管理器任务，并将尝试在作业中计划其他任务之前计划作业管理器任务。

jobManagerTask?: BatchJobManagerTaskOutput

属性值

BatchJobManagerTaskOutput

jobPreparationTask

根据此计划创建的作业的作业准备任务。 如果作业具有作业准备任务，批处理服务将在节点上运行作业准备任务，然后再在该计算节点上启动该作业的任何任务。

jobPreparationTask?: BatchJobPreparationTaskOutput

属性值

BatchJobPreparationTaskOutput

jobReleaseTask

根据此计划创建的作业的作业发布任务。 作业发布任务的主要用途是撤消作业准备任务对节点所做的更改。 示例活动包括删除本地文件或关闭在作业准备过程中启动的服务。 如果不同时指定作业的作业准备任务，则无法指定作业发布任务。 Batch 服务在运行作业准备任务的计算节点上运行作业发布任务。

jobReleaseTask?: BatchJobReleaseTaskOutput

属性值

BatchJobReleaseTaskOutput

maxParallelTasks

可为作业并行执行的最大任务数。 （默认情况下，此属性不可用。请联系支持人员了解更多信息）maxParallelTasks 的值必须为 -1 或大于 0（如果指定）。 如果未指定，则默认值为 -1，这意味着一次可以运行的任务数没有限制。 使用更新作业 API 创建作业后，可以更新作业的 maxParallelTasks。

maxParallelTasks?: number

属性值

number

metadata

与此计划下创建的每个作业关联的名称/值对列表作为元数据。 Batch 服务不向元数据分配任何含义;它仅用于使用用户代码。

metadata?: BatchMetadataItemOutput[]

属性值

BatchMetadataItemOutput[]

networkConfiguration

（默认情况下，此属性不可用。请联系支持人员了解更多信息）作业的网络配置。

networkConfiguration?: BatchJobNetworkConfigurationOutput

属性值

BatchJobNetworkConfigurationOutput

onAllTasksComplete

当在此计划下创建的作业中的所有任务都处于已完成状态时，Batch 服务应执行的操作。 请注意，如果作业不包含任何任务，则所有任务都被视为已完成。 因此，此选项最常用于作业管理器任务;如果要在没有作业管理器的情况下使用自动作业终止，则应最初将 OnAllTasksComplete 设置为 noaction，并将作业属性更新为在完成添加任务后将 OnAllTasksComplete 设置为 terminatejob。 默认值为 noaction。

可能的值：“noaction”、“terminatejob”

onAllTasksComplete?: string

属性值

string

onTaskFailure

Batch 服务在此计划下创建的作业中失败时，批处理服务应执行的操作。 如果任务失败，则任务被视为失败（如果有 failureInfo）。 如果任务在耗尽重试计数后使用非零退出代码完成，或者启动任务时出错（例如由于资源文件下载错误），则设置 failureInfo。 默认值为 noaction。

可能的值：“noaction”、“performexitoptionsjobaction”

onTaskFailure?: string

属性值

string

poolInfo

Batch 服务运行在此计划下创建的作业任务的池。

poolInfo: BatchPoolInfoOutput

属性值

BatchPoolInfoOutput

priority

在此计划下创建的作业的优先级。 优先级值的范围可以是 -1000 到 1000，-1000 是最低优先级，1000 是最高优先级。 默认值为 0。 此优先级用作作业计划下的所有作业的默认值。 使用更新作业 API 创建作业后，可以更新作业的优先级。

priority?: number

属性值

number

usesTaskDependencies

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

usesTaskDependencies?: boolean

属性值

boolean