Package software.amazon.awscdk.services.batch

Interface IJobDefinition

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IDependable, IEnvironmentAware, IResource, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

IEksJobDefinition, IEksJobDefinition.Jsii$Default, IJobDefinition.Jsii$Default

All Known Implementing Classes:

EcsJobDefinition, EksJobDefinition, IEksJobDefinition.Jsii$Proxy, IJobDefinition.Jsii$Proxy, MultiNodeJobDefinition

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-20T23:37:15.466Z")
@Stability(Stable)
public interface IJobDefinition
extends software.amazon.jsii.JsiiSerializable, IResource

Represents a JobDefinition.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	IJobDefinition.Jsii$Default	Internal default implementation for IJobDefinition.
static final class	IJobDefinition.Jsii$Proxy	A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method	Description
void	addRetryStrategy(RetryStrategy strategy)	Add a RetryStrategy to this JobDefinition.
String	getJobDefinitionArn()	The ARN of this job definition.
String	getJobDefinitionName()	The name of this job definition.
default Map<String,Object>	getParameters()	The default parameters passed to the container These parameters can be referenced in the command that you give to the container.
default Number	getRetryAttempts()	The number of times to retry a job.
List<RetryStrategy>	getRetryStrategies()	Defines the retry behavior for this job.
default Number	getSchedulingPriority()	The priority of this Job.
default Duration	getTimeout()	The timeout time for jobs that are submitted with this job definition.

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getJobDefinitionArn

@Stability(Stable)
@NotNull
String getJobDefinitionArn()

The ARN of this job definition.

getJobDefinitionName

@Stability(Stable)
@NotNull
String getJobDefinitionName()

The name of this job definition.

getRetryStrategies

@Stability(Stable)
@NotNull
List<RetryStrategy> getRetryStrategies()

Defines the retry behavior for this job.

Default: - no `RetryStrategy`

getParameters

@Stability(Stable)
@Nullable
default Map<String,Object> getParameters()

The default parameters passed to the container These parameters can be referenced in the command that you give to the container.

Default: none

See Also:

• https://docs.aws.amazon.com/batch/latest/userguide/job_definition_parameters.html#parameters

getRetryAttempts

@Stability(Stable)
@Nullable
default Number getRetryAttempts()

The number of times to retry a job.

The job is retried on failure the same number of attempts as the value.

Default: 1

getSchedulingPriority

@Stability(Stable)
@Nullable
default Number getSchedulingPriority()

The priority of this Job.

Only used in Fairshare Scheduling to decide which job to run first when there are multiple jobs with the same share identifier.

Default: none

getTimeout

@Stability(Stable)
@Nullable
default Duration getTimeout()

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.

Default: - no timeout

addRetryStrategy

@Stability(Stable)
void addRetryStrategy(@NotNull
 RetryStrategy strategy)

Add a RetryStrategy to this JobDefinition.

Parameters:

strategy - This parameter is required.