software.amazon.awscdk.services.ecs

Class FargateTaskDefinition

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.ecs.TaskDefinition

software.amazon.awscdk.services.ecs.FargateTaskDefinition

All Implemented Interfaces:

IConstruct, IDependable, IResource, IFargateTaskDefinition, ITaskDefinition

@Generated(value="jsii-pacmak/1.73.0 (build 6faeda3)",
           date="2023-01-31T18:37:00.358Z")
public class FargateTaskDefinition
extends TaskDefinition
implements IFargateTaskDefinition

The details of a task definition run on a Fargate cluster.

Example:

 FargateTaskDefinition fargateTaskDefinition = FargateTaskDefinition.Builder.create(this, "TaskDef")
         .memoryLimitMiB(512)
         .cpu(256)
         .build();
 ContainerDefinition container = fargateTaskDefinition.addContainer("WebContainer", ContainerDefinitionOptions.builder()
         // Use an image from DockerHub
         .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FargateTaskDefinition.Builder A fluent builder for FargateTaskDefinition.

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

IFargateTaskDefinition.Jsii$Default, IFargateTaskDefinition.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static IFargateTaskDefinition	fromFargateTaskDefinitionArn(software.constructs.Construct scope, java.lang.String id, java.lang.String fargateTaskDefinitionArn) Imports a task definition from the specified task definition ARN.
static IFargateTaskDefinition	fromFargateTaskDefinitionAttributes(software.constructs.Construct scope, java.lang.String id, FargateTaskDefinitionAttributes attrs) Import an existing Fargate task definition from its attributes.
java.lang.Number	getEphemeralStorageGiB() The amount (in GiB) of ephemeral storage to be allocated to the task.
NetworkMode	getNetworkMode() The Docker networking mode to use for the containers in the task.

Methods inherited from class software.amazon.awscdk.services.ecs.TaskDefinition

addContainer, addExtension, addFirelensLogRouter, addInferenceAccelerator, addPlacementConstraint, addToExecutionRolePolicy, addToTaskRolePolicy, addVolume, findContainer, fromTaskDefinitionArn, fromTaskDefinitionAttributes, getCompatibility, getContainers, getDefaultContainer, getExecutionRole, getFamily, getInferenceAccelerators, getIsEc2Compatible, getIsExternalCompatible, getIsFargateCompatible, getReferencesSecretJsonField, getTaskDefinitionArn, getTaskRole, obtainExecutionRole, setDefaultContainer, validate

Methods inherited from class software.amazon.awscdk.core.Resource

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

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.services.ecs.ITaskDefinition

getCompatibility, getExecutionRole, getIsEc2Compatible, getIsExternalCompatible, getIsFargateCompatible, getTaskDefinitionArn, getTaskRole

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

FargateTaskDefinition

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

FargateTaskDefinition

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

FargateTaskDefinition

public FargateTaskDefinition(software.constructs.Construct scope,
                             java.lang.String id,
                             FargateTaskDefinitionProps props)

Constructs a new instance of the FargateTaskDefinition class.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

FargateTaskDefinition

public FargateTaskDefinition(software.constructs.Construct scope,
                             java.lang.String id)

Constructs a new instance of the FargateTaskDefinition class.

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

fromFargateTaskDefinitionArn

public static IFargateTaskDefinition fromFargateTaskDefinitionArn(software.constructs.Construct scope,
                                                                  java.lang.String id,
                                                                  java.lang.String fargateTaskDefinitionArn)

Imports a task definition from the specified task definition ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

fargateTaskDefinitionArn - This parameter is required.

fromFargateTaskDefinitionAttributes

public static IFargateTaskDefinition fromFargateTaskDefinitionAttributes(software.constructs.Construct scope,
                                                                         java.lang.String id,
                                                                         FargateTaskDefinitionAttributes attrs)

Import an existing Fargate task definition from its attributes.

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

getNetworkMode

public NetworkMode getNetworkMode()

The Docker networking mode to use for the containers in the task.

Fargate tasks require the awsvpc network mode.

Specified by:

getNetworkMode in interface ITaskDefinition

Overrides:

getNetworkMode in class TaskDefinition

getEphemeralStorageGiB

public java.lang.Number getEphemeralStorageGiB()

The amount (in GiB) of ephemeral storage to be allocated to the task.

Overrides:

getEphemeralStorageGiB in class TaskDefinition