software.amazon.awssdk.services.batch.model

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

Modifier and Type	Method and Description
default JobDefinition.Builder	containerProperties(Consumer<ContainerProperties.Builder> containerProperties) An object with various properties specific to container-based jobs.
JobDefinition.Builder	containerProperties(ContainerProperties containerProperties) An object with various properties specific to container-based jobs.
JobDefinition.Builder	jobDefinitionArn(String jobDefinitionArn) The Amazon Resource Name (ARN) for the job definition.
JobDefinition.Builder	jobDefinitionName(String jobDefinitionName) The name of the job definition.
default JobDefinition.Builder	nodeProperties(Consumer<NodeProperties.Builder> nodeProperties) An object with various properties specific to multi-node parallel jobs.
JobDefinition.Builder	nodeProperties(NodeProperties nodeProperties) An object with various properties specific to multi-node parallel jobs.
JobDefinition.Builder	parameters(Map<String,String> parameters) Default parameters or parameter substitution placeholders that are set in the job definition.
JobDefinition.Builder	platformCapabilities(Collection<PlatformCapability> platformCapabilities) The platform capabilities required by the job definition.
JobDefinition.Builder	platformCapabilities(PlatformCapability... platformCapabilities) The platform capabilities required by the job definition.
JobDefinition.Builder	platformCapabilitiesWithStrings(Collection<String> platformCapabilities) The platform capabilities required by the job definition.
JobDefinition.Builder	platformCapabilitiesWithStrings(String... platformCapabilities) The platform capabilities required by the job definition.
JobDefinition.Builder	propagateTags(Boolean propagateTags) Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
default JobDefinition.Builder	retryStrategy(Consumer<RetryStrategy.Builder> retryStrategy) The retry strategy to use for failed jobs that are submitted with this job definition.
JobDefinition.Builder	retryStrategy(RetryStrategy retryStrategy) The retry strategy to use for failed jobs that are submitted with this job definition.
JobDefinition.Builder	revision(Integer revision) The revision of the job definition.
JobDefinition.Builder	status(String status) The status of the job definition.
JobDefinition.Builder	tags(Map<String,String> tags) The tags applied to the job definition.
default JobDefinition.Builder	timeout(Consumer<JobTimeout.Builder> timeout) The timeout configuration for jobs that are submitted with this job definition.
JobDefinition.Builder	timeout(JobTimeout timeout) The timeout configuration for jobs that are submitted with this job definition.
JobDefinition.Builder	type(String type) The type of job definition.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

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. If the job is run on Fargate resources, then multinode isn't supported. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the AWS Batch User Guide.

Parameters:

type - The type of job definition. If the job is run on Fargate resources, then multinode isn't supported. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the AWS Batch User Guide.

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 SubmitJob request override any corresponding parameter defaults from the job definition. For more information about specifying parameters, see Job Definition Parameters in the AWS 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 a SubmitJob request override any corresponding parameter defaults from the job definition. For more information about specifying parameters, see Job Definition Parameters in the AWS 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 that creates an instance of the RetryStrategy.Builder avoiding the need to create one manually via RetryStrategy.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to retryStrategy(RetryStrategy).

Parameters:

retryStrategy - a consumer that will call methods on RetryStrategy.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 container-based jobs.

Parameters:

containerProperties - An object with various properties specific to container-based jobs.

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 container-based jobs.

This is a convenience that creates an instance of the ContainerProperties.Builder avoiding the need to create one manually via ContainerProperties.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to containerProperties(ContainerProperties).

Parameters:

containerProperties - a consumer that will call methods on ContainerProperties.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 configuration for jobs that are submitted with this job definition. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven't finished.

Parameters:

timeout - The timeout configuration for jobs that are submitted with this job definition. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven'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 configuration for jobs that are submitted with this job definition. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven't finished.

This is a convenience that creates an instance of the JobTimeout.Builder avoiding the need to create one manually via JobTimeout.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to timeout(JobTimeout).

Parameters:

timeout - a consumer that will call methods on JobTimeout.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 specific to multi-node parallel jobs.

If the job runs on Fargate resources, then you must not specify nodeProperties; use containerProperties instead.

Parameters:

nodeProperties - An object with various properties specific to multi-node parallel jobs.

If the job runs on Fargate resources, then you must not specify nodeProperties; use containerProperties instead.

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 specific to multi-node parallel jobs.

If the job runs on Fargate resources, then you must not specify nodeProperties; use containerProperties instead.

This is a convenience that creates an instance of the NodeProperties.Builder avoiding the need to create one manually via NodeProperties.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to nodeProperties(NodeProperties).

Parameters:

nodeProperties - a consumer that will call methods on NodeProperties.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 applied to the job definition.

Parameters:

tags - The tags 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 during task creation. 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 FAILED state.

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 during task creation. 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 FAILED state.

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 specify FARGATE.

Parameters:

platformCapabilities - The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. Jobs run on Fargate resources specify FARGATE.

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 specify FARGATE.

Parameters:

platformCapabilities - The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. Jobs run on Fargate resources specify FARGATE.

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 specify FARGATE.

Parameters:

platformCapabilities - The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. Jobs run on Fargate resources specify FARGATE.

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 specify FARGATE.

Parameters:

platformCapabilities - The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. Jobs run on Fargate resources specify FARGATE.

Returns:

Returns a reference to this object so that method calls can be chained together.