Interface JobDefinition.Builder
-
- All Superinterfaces:
Buildable,CopyableBuilder<JobDefinition.Builder,JobDefinition>,SdkBuilder<JobDefinition.Builder,JobDefinition>,SdkPojo
- Enclosing class:
- JobDefinition
public static interface JobDefinition.Builder extends SdkPojo, CopyableBuilder<JobDefinition.Builder,JobDefinition>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description JobDefinition.BuildercontainerOrchestrationType(String containerOrchestrationType)The orchestration type of the compute environment.JobDefinition.BuildercontainerOrchestrationType(OrchestrationType containerOrchestrationType)The orchestration type of the compute environment.default JobDefinition.BuildercontainerProperties(Consumer<ContainerProperties.Builder> containerProperties)An object with various properties specific to Amazon ECS based jobs.JobDefinition.BuildercontainerProperties(ContainerProperties containerProperties)An object with various properties specific to Amazon ECS based jobs.default JobDefinition.BuildereksProperties(Consumer<EksProperties.Builder> eksProperties)An object with various properties that are specific to Amazon EKS based jobs.JobDefinition.BuildereksProperties(EksProperties eksProperties)An object with various properties that are specific to Amazon EKS based jobs.JobDefinition.BuilderjobDefinitionArn(String jobDefinitionArn)The Amazon Resource Name (ARN) for the job definition.JobDefinition.BuilderjobDefinitionName(String jobDefinitionName)The name of the job definition.default JobDefinition.BuildernodeProperties(Consumer<NodeProperties.Builder> nodeProperties)An object with various properties that are specific to multi-node parallel jobs.JobDefinition.BuildernodeProperties(NodeProperties nodeProperties)An object with various properties that are specific to multi-node parallel jobs.JobDefinition.Builderparameters(Map<String,String> parameters)Default parameters or parameter substitution placeholders that are set in the job definition.JobDefinition.BuilderplatformCapabilities(Collection<PlatformCapability> platformCapabilities)The platform capabilities required by the job definition.JobDefinition.BuilderplatformCapabilities(PlatformCapability... platformCapabilities)The platform capabilities required by the job definition.JobDefinition.BuilderplatformCapabilitiesWithStrings(String... platformCapabilities)The platform capabilities required by the job definition.JobDefinition.BuilderplatformCapabilitiesWithStrings(Collection<String> platformCapabilities)The platform capabilities required by the job definition.JobDefinition.BuilderpropagateTags(Boolean propagateTags)Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.default JobDefinition.BuilderretryStrategy(Consumer<RetryStrategy.Builder> retryStrategy)The retry strategy to use for failed jobs that are submitted with this job definition.JobDefinition.BuilderretryStrategy(RetryStrategy retryStrategy)The retry strategy to use for failed jobs that are submitted with this job definition.JobDefinition.Builderrevision(Integer revision)The revision of the job definition.JobDefinition.BuilderschedulingPriority(Integer schedulingPriority)The scheduling priority of the job definition.JobDefinition.Builderstatus(String status)The status of the job definition.JobDefinition.Buildertags(Map<String,String> tags)The tags that are applied to the job definition.default JobDefinition.Buildertimeout(Consumer<JobTimeout.Builder> timeout)The timeout time for jobs that are submitted with this job definition.JobDefinition.Buildertimeout(JobTimeout timeout)The timeout time for jobs that are submitted with this job definition.JobDefinition.Buildertype(String type)The type of job definition.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
-
-
-
Method Detail
-
jobDefinitionName
JobDefinition.Builder jobDefinitionName(String jobDefinitionName)
The name of the job definition.
- Parameters:
jobDefinitionName- The name of the job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
jobDefinitionArn
JobDefinition.Builder jobDefinitionArn(String jobDefinitionArn)
The Amazon Resource Name (ARN) for the job definition.
- Parameters:
jobDefinitionArn- The Amazon Resource Name (ARN) for the job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
revision
JobDefinition.Builder revision(Integer revision)
The revision of the job definition.
- Parameters:
revision- The revision of the job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
JobDefinition.Builder status(String status)
The status of the job definition.
- Parameters:
status- The status of the job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
type
JobDefinition.Builder type(String type)
The type of job definition. It's either
containerormultinode. If the job is run on Fargate resources, thenmultinodeisn't supported. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the Batch User Guide.- Parameters:
type- The type of job definition. It's eithercontainerormultinode. If the job is run on Fargate resources, thenmultinodeisn't supported. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the Batch User Guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schedulingPriority
JobDefinition.Builder schedulingPriority(Integer schedulingPriority)
The scheduling priority of the job definition. This only affects jobs in job queues with a fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower scheduling priority.
- Parameters:
schedulingPriority- The scheduling priority of the job definition. This only affects jobs in job queues with a fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower scheduling priority.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
JobDefinition.Builder parameters(Map<String,String> parameters)
Default parameters or parameter substitution placeholders that are set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a
SubmitJobrequest override any corresponding parameter defaults from the job definition. For more information about specifying parameters, see Job definition parameters in the Batch User Guide.- Parameters:
parameters- Default parameters or parameter substitution placeholders that are set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in aSubmitJobrequest override any corresponding parameter defaults from the job definition. For more information about specifying parameters, see Job definition parameters in the Batch User Guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
retryStrategy
JobDefinition.Builder retryStrategy(RetryStrategy retryStrategy)
The retry strategy to use for failed jobs that are submitted with this job definition.
- Parameters:
retryStrategy- The retry strategy to use for failed jobs that are submitted with this job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
retryStrategy
default JobDefinition.Builder retryStrategy(Consumer<RetryStrategy.Builder> retryStrategy)
The retry strategy to use for failed jobs that are submitted with this job definition.
This is a convenience method that creates an instance of theRetryStrategy.Builderavoiding the need to create one manually viaRetryStrategy.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toretryStrategy(RetryStrategy).- Parameters:
retryStrategy- a consumer that will call methods onRetryStrategy.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
retryStrategy(RetryStrategy)
-
containerProperties
JobDefinition.Builder containerProperties(ContainerProperties containerProperties)
An object with various properties specific to Amazon ECS based jobs. Valid values are
containerProperties,eksProperties, andnodeProperties. Only one can be specified.- Parameters:
containerProperties- An object with various properties specific to Amazon ECS based jobs. Valid values arecontainerProperties,eksProperties, andnodeProperties. Only one can be specified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
containerProperties
default JobDefinition.Builder containerProperties(Consumer<ContainerProperties.Builder> containerProperties)
An object with various properties specific to Amazon ECS based jobs. Valid values are
This is a convenience method that creates an instance of thecontainerProperties,eksProperties, andnodeProperties. Only one can be specified.ContainerProperties.Builderavoiding the need to create one manually viaContainerProperties.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tocontainerProperties(ContainerProperties).- Parameters:
containerProperties- a consumer that will call methods onContainerProperties.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
containerProperties(ContainerProperties)
-
timeout
JobDefinition.Builder timeout(JobTimeout timeout)
The timeout time for jobs that are submitted with this job definition. After the amount of time you specify passes, Batch terminates your jobs if they aren't finished.
- Parameters:
timeout- The timeout time for jobs that are submitted with this job definition. After the amount of time you specify passes, Batch terminates your jobs if they aren't finished.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
timeout
default JobDefinition.Builder timeout(Consumer<JobTimeout.Builder> timeout)
The timeout time for jobs that are submitted with this job definition. After the amount of time you specify passes, Batch terminates your jobs if they aren't finished.
This is a convenience method that creates an instance of theJobTimeout.Builderavoiding the need to create one manually viaJobTimeout.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed totimeout(JobTimeout).- Parameters:
timeout- a consumer that will call methods onJobTimeout.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
timeout(JobTimeout)
-
nodeProperties
JobDefinition.Builder nodeProperties(NodeProperties nodeProperties)
An object with various properties that are specific to multi-node parallel jobs. Valid values are
containerProperties,eksProperties, andnodeProperties. Only one can be specified.If the job runs on Fargate resources, don't specify
nodeProperties. UsecontainerPropertiesinstead.- Parameters:
nodeProperties- An object with various properties that are specific to multi-node parallel jobs. Valid values arecontainerProperties,eksProperties, andnodeProperties. Only one can be specified.If the job runs on Fargate resources, don't specify
nodeProperties. UsecontainerPropertiesinstead.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
nodeProperties
default JobDefinition.Builder nodeProperties(Consumer<NodeProperties.Builder> nodeProperties)
An object with various properties that are specific to multi-node parallel jobs. Valid values are
containerProperties,eksProperties, andnodeProperties. Only one can be specified. This is a convenience method that creates an instance of theIf the job runs on Fargate resources, don't specify
nodeProperties. UsecontainerPropertiesinstead.NodeProperties.Builderavoiding the need to create one manually viaNodeProperties.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tonodeProperties(NodeProperties).- Parameters:
nodeProperties- a consumer that will call methods onNodeProperties.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
nodeProperties(NodeProperties)
-
tags
JobDefinition.Builder tags(Map<String,String> tags)
The tags that are applied to the job definition.
- Parameters:
tags- The tags that are applied to the job definition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
propagateTags
JobDefinition.Builder propagateTags(Boolean propagateTags)
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the tasks when the tasks are created. For tags with the same name, job tags are given priority over job definitions tags. If the total number of combined tags from the job and job definition is over 50, the job is moved to the
FAILEDstate.- Parameters:
propagateTags- Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the tasks when the tasks are created. For tags with the same name, job tags are given priority over job definitions tags. If the total number of combined tags from the job and job definition is over 50, the job is moved to theFAILEDstate.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platformCapabilitiesWithStrings
JobDefinition.Builder platformCapabilitiesWithStrings(Collection<String> platformCapabilities)
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2. Jobs run on Fargate resources specifyFARGATE.- Parameters:
platformCapabilities- The platform capabilities required by the job definition. If no value is specified, it defaults toEC2. Jobs run on Fargate resources specifyFARGATE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platformCapabilitiesWithStrings
JobDefinition.Builder platformCapabilitiesWithStrings(String... platformCapabilities)
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2. Jobs run on Fargate resources specifyFARGATE.- Parameters:
platformCapabilities- The platform capabilities required by the job definition. If no value is specified, it defaults toEC2. Jobs run on Fargate resources specifyFARGATE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platformCapabilities
JobDefinition.Builder platformCapabilities(Collection<PlatformCapability> platformCapabilities)
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2. Jobs run on Fargate resources specifyFARGATE.- Parameters:
platformCapabilities- The platform capabilities required by the job definition. If no value is specified, it defaults toEC2. Jobs run on Fargate resources specifyFARGATE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platformCapabilities
JobDefinition.Builder platformCapabilities(PlatformCapability... platformCapabilities)
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2. Jobs run on Fargate resources specifyFARGATE.- Parameters:
platformCapabilities- The platform capabilities required by the job definition. If no value is specified, it defaults toEC2. Jobs run on Fargate resources specifyFARGATE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
eksProperties
JobDefinition.Builder eksProperties(EksProperties eksProperties)
An object with various properties that are specific to Amazon EKS based jobs. Valid values are
containerProperties,eksProperties, andnodeProperties. Only one can be specified.- Parameters:
eksProperties- An object with various properties that are specific to Amazon EKS based jobs. Valid values arecontainerProperties,eksProperties, andnodeProperties. Only one can be specified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
eksProperties
default JobDefinition.Builder eksProperties(Consumer<EksProperties.Builder> eksProperties)
An object with various properties that are specific to Amazon EKS based jobs. Valid values are
This is a convenience method that creates an instance of thecontainerProperties,eksProperties, andnodeProperties. Only one can be specified.EksProperties.Builderavoiding the need to create one manually viaEksProperties.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toeksProperties(EksProperties).- Parameters:
eksProperties- a consumer that will call methods onEksProperties.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
eksProperties(EksProperties)
-
containerOrchestrationType
JobDefinition.Builder containerOrchestrationType(String containerOrchestrationType)
The orchestration type of the compute environment. The valid values are
ECS(default) orEKS.- Parameters:
containerOrchestrationType- The orchestration type of the compute environment. The valid values areECS(default) orEKS.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
OrchestrationType,OrchestrationType
-
containerOrchestrationType
JobDefinition.Builder containerOrchestrationType(OrchestrationType containerOrchestrationType)
The orchestration type of the compute environment. The valid values are
ECS(default) orEKS.- Parameters:
containerOrchestrationType- The orchestration type of the compute environment. The valid values areECS(default) orEKS.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
OrchestrationType,OrchestrationType
-
-