interface EcsJobDefinitionProps

Language	Type name
.NET	Amazon.CDK.AWS.Batch.EcsJobDefinitionProps
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsbatch#EcsJobDefinitionProps
Java	software.amazon.awscdk.services.batch.EcsJobDefinitionProps
Python	aws_cdk.aws_batch.EcsJobDefinitionProps
TypeScript (source)	aws-cdk-lib » aws_batch » EcsJobDefinitionProps

Props for EcsJobDefinition.

Example

declare const myFileSystem: efs.IFileSystem;
declare const myJobRole: iam.Role;
myFileSystem.grantRead(myJobRole);

const jobDefn = new batch.EcsJobDefinition(this, 'JobDefn', {
  container: new batch.EcsEc2ContainerDefinition(this, 'containerDefn', {
    image: ecs.ContainerImage.fromRegistry('public.ecr.aws/amazonlinux/amazonlinux:latest'),
    memory: cdk.Size.mebibytes(2048),
    cpu: 256,
    volumes: [batch.EcsVolume.efs({
      name: 'myVolume',
      fileSystem: myFileSystem,
      containerPath: '/Volumes/myVolume',
      useJobRole: true,
    })],
    jobRole: myJobRole,
  }),
});

Properties

Name	Type	Description
container	IEcsContainerDefinition	The container that this job will run.
jobDefinitionName?	string	The name of this job definition.
parameters?	{ [string]: any }	The default parameters passed to the container These parameters can be referenced in the command that you give to the container.
propagateTags?	boolean	Whether to propagate tags from the JobDefinition to the ECS task that Batch spawns.
retryAttempts?	number	The number of times to retry a job.
retryStrategies?	RetryStrategy[]	Defines the retry behavior for this job.
schedulingPriority?	number	The priority of this Job.
timeout?	Duration	The timeout time for jobs that are submitted with this job definition.

---

container

Type: IEcsContainerDefinition

The container that this job will run.

---

jobDefinitionName?

Type: string (optional, default: generated by CloudFormation)

The name of this job definition.

---

parameters?

Type: { [string]: any } (optional, default: none)

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

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

---

propagateTags?

Type: boolean (optional, default: false)

Whether to propagate tags from the JobDefinition to the ECS task that Batch spawns.

---

retryAttempts?

Type: number (optional, default: 1)

The number of times to retry a job.

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

---

retryStrategies?

Type: RetryStrategy[] (optional, default: no RetryStrategy)

Defines the retry behavior for this job.

---

schedulingPriority?

Type: number (optional, default: none)

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.

---

timeout?

Type: Duration (optional, default: no 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.