software.amazon.awscdk.services.ecs

Class TaskDefinition

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.ecs.TaskDefinition

All Implemented Interfaces:

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

Direct Known Subclasses:

Ec2TaskDefinition, FargateTaskDefinition

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:06.827Z")
 @Stability(value=Experimental)
public class TaskDefinition
extends Resource
implements ITaskDefinition

(experimental) The base class for all task definitions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TaskDefinition.Builder (experimental) A fluent builder for TaskDefinition.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.ecs.ITaskDefinition

ITaskDefinition.Jsii$Default, ITaskDefinition.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
	TaskDefinition(software.constructs.Construct scope, String id, TaskDefinitionProps props) (experimental) Constructs a new instance of the TaskDefinition class.
protected	TaskDefinition(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	TaskDefinition(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
ContainerDefinition	addContainer(String id, ContainerDefinitionOptions props) (experimental) Adds a new container to the task definition.
void	addExtension(ITaskDefinitionExtension extension) (experimental) Adds the specified extention to the task definition.
FirelensLogRouter	addFirelensLogRouter(String id, FirelensLogRouterDefinitionOptions props) (experimental) Adds a firelens log router to the task definition.
void	addInferenceAccelerator(InferenceAccelerator inferenceAccelerator) (experimental) Adds an inference accelerator to the task definition.
void	addPlacementConstraint(PlacementConstraint constraint) (experimental) Adds the specified placement constraint to the task definition.
void	addToExecutionRolePolicy(PolicyStatement statement) (experimental) Adds a policy statement to the task execution IAM role.
void	addToTaskRolePolicy(PolicyStatement statement) (experimental) Adds a policy statement to the task IAM role.
void	addVolume(Volume volume) (experimental) Adds a volume to the task definition.
static ITaskDefinition	fromTaskDefinitionArn(software.constructs.Construct scope, String id, String taskDefinitionArn) (experimental) Imports a task definition from the specified task definition ARN.
static ITaskDefinition	fromTaskDefinitionAttributes(software.constructs.Construct scope, String id, TaskDefinitionAttributes attrs) (experimental) Create a task definition from a task definition reference.
Compatibility	getCompatibility() (experimental) The task launch type compatibility requirement.
protected List<ContainerDefinition>	getContainers() (experimental) The container definitions.
ContainerDefinition	getDefaultContainer() (experimental) Default container for this task.
IRole	getExecutionRole() (experimental) Execution role for this task definition.
String	getFamily() (experimental) The name of a family that this task definition is registered to.
List<InferenceAccelerator>	getInferenceAccelerators() (experimental) Public getter method to access list of inference accelerators attached to the instance.
Boolean	getIsEc2Compatible() (experimental) Return true if the task definition can be run on an EC2 cluster.
Boolean	getIsExternalCompatible() (experimental) Return true if the task definition can be run on a ECS anywhere cluster.
Boolean	getIsFargateCompatible() (experimental) Return true if the task definition can be run on a Fargate cluster.
NetworkMode	getNetworkMode() (experimental) The networking mode to use for the containers in the task.
Boolean	getReferencesSecretJsonField() (experimental) Whether this task definition has at least a container that references a specific JSON field of a secret stored in Secrets Manager.
String	getTaskDefinitionArn() (experimental) The full Amazon Resource Name (ARN) of the task definition.
IRole	getTaskRole() (experimental) The name of the IAM role that grants containers in the task permission to call AWS APIs on your behalf.
IRole	obtainExecutionRole() (experimental) Creates the task execution IAM role if it doesn't already exist.
void	setDefaultContainer(ContainerDefinition value) (experimental) Default container for this task.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

TaskDefinition

protected TaskDefinition(software.amazon.jsii.JsiiObjectRef objRef)

TaskDefinition

protected TaskDefinition(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

TaskDefinition

@Stability(value=Experimental)
public TaskDefinition(@NotNull
                                                     software.constructs.Construct scope,
                                                     @NotNull
                                                     String id,
                                                     @NotNull
                                                     TaskDefinitionProps props)

(experimental) Constructs a new instance of the TaskDefinition class.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromTaskDefinitionArn

@Stability(value=Experimental)
 @NotNull
public static ITaskDefinition fromTaskDefinitionArn(@NotNull
                                                                                             software.constructs.Construct scope,
                                                                                             @NotNull
                                                                                             String id,
                                                                                             @NotNull
                                                                                             String taskDefinitionArn)

(experimental) Imports a task definition from the specified task definition ARN.

The task will have a compatibility of EC2+Fargate.

Parameters:

scope - This parameter is required.

id - This parameter is required.

taskDefinitionArn - This parameter is required.

fromTaskDefinitionAttributes

@Stability(value=Experimental)
 @NotNull
public static ITaskDefinition fromTaskDefinitionAttributes(@NotNull
                                                                                                    software.constructs.Construct scope,
                                                                                                    @NotNull
                                                                                                    String id,
                                                                                                    @NotNull
                                                                                                    TaskDefinitionAttributes attrs)

(experimental) Create a task definition from a task definition reference.

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

addContainer

@Stability(value=Experimental)
 @NotNull
public ContainerDefinition addContainer(@NotNull
                                                                                 String id,
                                                                                 @NotNull
                                                                                 ContainerDefinitionOptions props)

(experimental) Adds a new container to the task definition.

Parameters:

id - This parameter is required.

props - This parameter is required.

addExtension

@Stability(value=Experimental)
public void addExtension(@NotNull
                                                        ITaskDefinitionExtension extension)

(experimental) Adds the specified extention to the task definition.

Extension can be used to apply a packaged modification to a task definition.

Parameters:

extension - This parameter is required.

addFirelensLogRouter

@Stability(value=Experimental)
 @NotNull
public FirelensLogRouter addFirelensLogRouter(@NotNull
                                                                                       String id,
                                                                                       @NotNull
                                                                                       FirelensLogRouterDefinitionOptions props)

(experimental) Adds a firelens log router to the task definition.

Parameters:

id - This parameter is required.

props - This parameter is required.

addInferenceAccelerator

@Stability(value=Experimental)
public void addInferenceAccelerator(@NotNull
                                                                   InferenceAccelerator inferenceAccelerator)

(experimental) Adds an inference accelerator to the task definition.

Parameters:

inferenceAccelerator - This parameter is required.

addPlacementConstraint

@Stability(value=Experimental)
public void addPlacementConstraint(@NotNull
                                                                  PlacementConstraint constraint)

(experimental) Adds the specified placement constraint to the task definition.

Parameters:

constraint - This parameter is required.

addToExecutionRolePolicy

@Stability(value=Experimental)
public void addToExecutionRolePolicy(@NotNull
                                                                    PolicyStatement statement)

(experimental) Adds a policy statement to the task execution IAM role.

Parameters:

statement - This parameter is required.

addToTaskRolePolicy

@Stability(value=Experimental)
public void addToTaskRolePolicy(@NotNull
                                                               PolicyStatement statement)

(experimental) Adds a policy statement to the task IAM role.

Parameters:

statement - This parameter is required.

addVolume

@Stability(value=Experimental)
public void addVolume(@NotNull
                                                     Volume volume)

(experimental) Adds a volume to the task definition.

Parameters:

volume - This parameter is required.

obtainExecutionRole

@Stability(value=Experimental)
 @NotNull
public IRole obtainExecutionRole()

(experimental) Creates the task execution IAM role if it doesn't already exist.

getCompatibility

@Stability(value=Experimental)
 @NotNull
public Compatibility getCompatibility()

(experimental) The task launch type compatibility requirement.

Specified by:

getCompatibility in interface ITaskDefinition

getContainers

@Stability(value=Experimental)
 @NotNull
protected List<ContainerDefinition> getContainers()

(experimental) The container definitions.

getFamily

@Stability(value=Experimental)
 @NotNull
public String getFamily()

(experimental) The name of a family that this task definition is registered to.

A family groups multiple versions of a task definition.

getInferenceAccelerators

@Stability(value=Experimental)
 @NotNull
public List<InferenceAccelerator> getInferenceAccelerators()

(experimental) Public getter method to access list of inference accelerators attached to the instance.

getIsEc2Compatible

@Stability(value=Experimental)
 @NotNull
public Boolean getIsEc2Compatible()

(experimental) Return true if the task definition can be run on an EC2 cluster.

Specified by:

getIsEc2Compatible in interface ITaskDefinition

getIsExternalCompatible

@Stability(value=Experimental)
 @NotNull
public Boolean getIsExternalCompatible()

(experimental) Return true if the task definition can be run on a ECS anywhere cluster.

Specified by:

getIsExternalCompatible in interface ITaskDefinition

getIsFargateCompatible

@Stability(value=Experimental)
 @NotNull
public Boolean getIsFargateCompatible()

(experimental) Return true if the task definition can be run on a Fargate cluster.

Specified by:

getIsFargateCompatible in interface ITaskDefinition

getNetworkMode

@Stability(value=Experimental)
 @NotNull
public NetworkMode getNetworkMode()

(experimental) The networking mode to use for the containers in the task.

Specified by:

getNetworkMode in interface ITaskDefinition

getTaskDefinitionArn

@Stability(value=Experimental)
 @NotNull
public String getTaskDefinitionArn()

(experimental) The full Amazon Resource Name (ARN) of the task definition.

Specified by:

getTaskDefinitionArn in interface ITaskDefinition

getTaskRole

@Stability(value=Experimental)
 @NotNull
public IRole getTaskRole()

(experimental) The name of the IAM role that grants containers in the task permission to call AWS APIs on your behalf.

Specified by:

getTaskRole in interface ITaskDefinition

getExecutionRole

@Stability(value=Experimental)
 @Nullable
public IRole getExecutionRole()

(experimental) Execution role for this task definition.

Specified by:

getExecutionRole in interface ITaskDefinition

getReferencesSecretJsonField

@Stability(value=Experimental)
 @Nullable
public Boolean getReferencesSecretJsonField()

(experimental) Whether this task definition has at least a container that references a specific JSON field of a secret stored in Secrets Manager.

getDefaultContainer

@Stability(value=Experimental)
 @Nullable
public ContainerDefinition getDefaultContainer()

(experimental) Default container for this task.

Load balancers will send traffic to this container. The first essential container that is added to this task will become the default container.

setDefaultContainer

@Stability(value=Experimental)
public void setDefaultContainer(@Nullable
                                                               ContainerDefinition value)

(experimental) Default container for this task.

Load balancers will send traffic to this container. The first essential container that is added to this task will become the default container.