JobSpecification Class
- java.
lang. Object - com.
microsoft. azure. batch. protocol. models. JobSpecification
- com.
public class JobSpecification
Specifies details of the Jobs to be created on a schedule.
Constructor Summary
Constructor | Description | |
---|---|---|
JobSpecification() |
Method Summary
Modifier and Type | Method and Description |
---|---|
Boolean |
allowTaskPreemption()
Get if the value is set to True, other high priority jobs submitted to the system will take precedence and will be able requeue tasks from this job. |
List<Environment |
commonEnvironmentSettings()
Get individual Tasks can override an environment setting specified here by specifying the same setting name with a different value. |
Job |
constraints()
Get the constraints value. |
String |
displayName()
Get the name need not be unique and can contain any Unicode characters up to a maximum length of 1024. |
Job |
jobManagerTask()
Get if the Job does not specify a Job Manager Task, the user must explicitly add Tasks to the Job using the Task API. |
Job |
jobPreparationTask()
Get if a Job has a Job Preparation Task, the Batch service will run the Job Preparation Task on a Node before starting any Tasks of that Job on that Compute Node. |
Job |
jobReleaseTask()
Get the primary purpose of the Job Release Task is to undo changes to Nodes made by the Job Preparation Task. |
Integer |
maxParallelTasks()
Get the value of max |
List<Metadata |
metadata()
Get the Batch service does not assign any meaning to metadata; it is solely for the use of user code. |
Job |
networkConfiguration()
Get the network |
On |
onAllTasksComplete()
Get note that if a Job contains no Tasks, then all Tasks are considered complete. |
On |
onTaskFailure()
Get the default is noaction. |
Pool |
poolInfo()
Get the pool |
Integer |
priority()
Get priority values can range from -1000 to 1000, with -1000 being the lowest priority and 1000 being the highest priority. |
Boolean |
usesTaskDependencies()
Get the uses |
Job |
withAllowTaskPreemption(Boolean allowTaskPreemption)
Set if the value is set to True, other high priority jobs submitted to the system will take precedence and will be able requeue tasks from this job. |
Job |
withCommonEnvironmentSettings(List<EnvironmentSetting> commonEnvironmentSettings)
Set individual Tasks can override an environment setting specified here by specifying the same setting name with a different value. |
Job |
withConstraints(JobConstraints constraints)
Set the constraints value. |
Job |
withDisplayName(String displayName)
Set the name need not be unique and can contain any Unicode characters up to a maximum length of 1024. |
Job |
withJobManagerTask(JobManagerTask jobManagerTask)
Set if the Job does not specify a Job Manager Task, the user must explicitly add Tasks to the Job using the Task API. |
Job |
withJobPreparationTask(JobPreparationTask jobPreparationTask)
Set if a Job has a Job Preparation Task, the Batch service will run the Job Preparation Task on a Node before starting any Tasks of that Job on that Compute Node. |
Job |
withJobReleaseTask(JobReleaseTask jobReleaseTask)
Set the primary purpose of the Job Release Task is to undo changes to Nodes made by the Job Preparation Task. |
Job |
withMaxParallelTasks(Integer maxParallelTasks)
Set the value of max |
Job |
withMetadata(List<MetadataItem> metadata)
Set the Batch service does not assign any meaning to metadata; it is solely for the use of user code. |
Job |
withNetworkConfiguration(JobNetworkConfiguration networkConfiguration)
Set the network |
Job |
withOnAllTasksComplete(OnAllTasksComplete onAllTasksComplete)
Set note that if a Job contains no Tasks, then all Tasks are considered complete. |
Job |
withOnTaskFailure(OnTaskFailure onTaskFailure)
Set the default is noaction. |
Job |
withPoolInfo(PoolInformation poolInfo)
Set the pool |
Job |
withPriority(Integer priority)
Set priority values can range from -1000 to 1000, with -1000 being the lowest priority and 1000 being the highest priority. |
Job |
withUsesTaskDependencies(Boolean usesTaskDependencies)
Set the uses |
Methods inherited from java.lang.Object
Constructor Details
JobSpecification
public JobSpecification()
Method Details
allowTaskPreemption
public Boolean allowTaskPreemption()
Get if the value is set to True, other high priority jobs submitted to the system will take precedence and will be able requeue tasks from this job. You can update a job's allowTaskPreemption after it has been created using the update job API.
Returns:
commonEnvironmentSettings
public List
Get individual Tasks can override an environment setting specified here by specifying the same setting name with a different value.
Returns:
constraints
public JobConstraints constraints()
Get the constraints value.
Returns:
displayName
public String displayName()
Get the name need not be unique and can contain any Unicode characters up to a maximum length of 1024.
Returns:
jobManagerTask
public JobManagerTask jobManagerTask()
Get if the Job does not specify a Job Manager Task, the user must explicitly add Tasks to the Job using the Task API. If the Job does specify a Job Manager Task, the Batch service creates the Job Manager Task when the Job is created, and will try to schedule the Job Manager Task before scheduling other Tasks in the Job.
Returns:
jobPreparationTask
public JobPreparationTask jobPreparationTask()
Get if a Job has a Job Preparation Task, the Batch service will run the Job Preparation Task on a Node before starting any Tasks of that Job on that Compute Node.
Returns:
jobReleaseTask
public JobReleaseTask jobReleaseTask()
Get the primary purpose of the Job Release Task is to undo changes to Nodes made by the Job Preparation Task. Example activities include deleting local files, or shutting down services that were started as part of Job preparation. A Job Release Task cannot be specified without also specifying a Job Preparation Task for the Job. The Batch service runs the Job Release Task on the Compute Nodes that have run the Job Preparation Task.
Returns:
maxParallelTasks
public Integer maxParallelTasks()
Get the value of maxParallelTasks must be -1 or greater than 0 if specified. If not specified, the default value is -1, which means there's no limit to the number of tasks that can be run at once. You can update a job's maxParallelTasks after it has been created using the update job API.
Returns:
metadata
public List
Get the Batch service does not assign any meaning to metadata; it is solely for the use of user code.
Returns:
networkConfiguration
public JobNetworkConfiguration networkConfiguration()
Get the networkConfiguration value.
Returns:
onAllTasksComplete
public OnAllTasksComplete onAllTasksComplete()
Get note that if a Job contains no Tasks, then all Tasks are considered complete. This option is therefore most commonly used with a Job Manager task; if you want to use automatic Job termination without a Job Manager, you should initially set onAllTasksComplete to noaction and update the Job properties to set onAllTasksComplete to terminatejob once you have finished adding Tasks. The default is noaction. Possible values include: 'noAction', 'terminateJob'.
Returns:
onTaskFailure
public OnTaskFailure onTaskFailure()
Get the default is noaction. Possible values include: 'noAction', 'performExitOptionsJobAction'.
Returns:
poolInfo
public PoolInformation poolInfo()
Get the poolInfo value.
Returns:
priority
public Integer priority()
Get priority values can range from -1000 to 1000, with -1000 being the lowest priority and 1000 being the highest priority. The default value is 0. This priority is used as the default for all Jobs under the Job Schedule. You can update a Job's priority after it has been created using by using the update Job API.
Returns:
usesTaskDependencies
public Boolean usesTaskDependencies()
Get the usesTaskDependencies value.
Returns:
withAllowTaskPreemption
public JobSpecification withAllowTaskPreemption(Boolean allowTaskPreemption)
Set if the value is set to True, other high priority jobs submitted to the system will take precedence and will be able requeue tasks from this job. You can update a job's allowTaskPreemption after it has been created using the update job API.
Parameters:
Returns:
withCommonEnvironmentSettings
public JobSpecification withCommonEnvironmentSettings(List
Set individual Tasks can override an environment setting specified here by specifying the same setting name with a different value.
Parameters:
Returns:
withConstraints
public JobSpecification withConstraints(JobConstraints constraints)
Set the constraints value.
Parameters:
Returns:
withDisplayName
public JobSpecification withDisplayName(String displayName)
Set the name need not be unique and can contain any Unicode characters up to a maximum length of 1024.
Parameters:
Returns:
withJobManagerTask
public JobSpecification withJobManagerTask(JobManagerTask jobManagerTask)
Set if the Job does not specify a Job Manager Task, the user must explicitly add Tasks to the Job using the Task API. If the Job does specify a Job Manager Task, the Batch service creates the Job Manager Task when the Job is created, and will try to schedule the Job Manager Task before scheduling other Tasks in the Job.
Parameters:
Returns:
withJobPreparationTask
public JobSpecification withJobPreparationTask(JobPreparationTask jobPreparationTask)
Set if a Job has a Job Preparation Task, the Batch service will run the Job Preparation Task on a Node before starting any Tasks of that Job on that Compute Node.
Parameters:
Returns:
withJobReleaseTask
public JobSpecification withJobReleaseTask(JobReleaseTask jobReleaseTask)
Set the primary purpose of the Job Release Task is to undo changes to Nodes made by the Job Preparation Task. Example activities include deleting local files, or shutting down services that were started as part of Job preparation. A Job Release Task cannot be specified without also specifying a Job Preparation Task for the Job. The Batch service runs the Job Release Task on the Compute Nodes that have run the Job Preparation Task.
Parameters:
Returns:
withMaxParallelTasks
public JobSpecification withMaxParallelTasks(Integer maxParallelTasks)
Set the value of maxParallelTasks must be -1 or greater than 0 if specified. If not specified, the default value is -1, which means there's no limit to the number of tasks that can be run at once. You can update a job's maxParallelTasks after it has been created using the update job API.
Parameters:
Returns:
withMetadata
public JobSpecification withMetadata(List
Set the Batch service does not assign any meaning to metadata; it is solely for the use of user code.
Parameters:
Returns:
withNetworkConfiguration
public JobSpecification withNetworkConfiguration(JobNetworkConfiguration networkConfiguration)
Set the networkConfiguration value.
Parameters:
Returns:
withOnAllTasksComplete
public JobSpecification withOnAllTasksComplete(OnAllTasksComplete onAllTasksComplete)
Set note that if a Job contains no Tasks, then all Tasks are considered complete. This option is therefore most commonly used with a Job Manager task; if you want to use automatic Job termination without a Job Manager, you should initially set onAllTasksComplete to noaction and update the Job properties to set onAllTasksComplete to terminatejob once you have finished adding Tasks. The default is noaction. Possible values include: 'noAction', 'terminateJob'.
Parameters:
Returns:
withOnTaskFailure
public JobSpecification withOnTaskFailure(OnTaskFailure onTaskFailure)
Set the default is noaction. Possible values include: 'noAction', 'performExitOptionsJobAction'.
Parameters:
Returns:
withPoolInfo
public JobSpecification withPoolInfo(PoolInformation poolInfo)
Set the poolInfo value.
Parameters:
Returns:
withPriority
public JobSpecification withPriority(Integer priority)
Set priority values can range from -1000 to 1000, with -1000 being the lowest priority and 1000 being the highest priority. The default value is 0. This priority is used as the default for all Jobs under the Job Schedule. You can update a Job's priority after it has been created using by using the update Job API.
Parameters:
Returns:
withUsesTaskDependencies
public JobSpecification withUsesTaskDependencies(Boolean usesTaskDependencies)
Set the usesTaskDependencies value.
Parameters:
Returns:
Applies to
Azure SDK for Java