Package software.amazon.awscdk.services.ecs

Interface FargateServiceProps

All Superinterfaces:

BaseServiceOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

FargateServiceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.118.0 (build 02eec31)",
           date="2025-11-04T09:27:40.930Z")
@Stability(Stable)
public interface FargateServiceProps
extends software.amazon.jsii.JsiiSerializable, BaseServiceOptions

The properties for defining a service using the Fargate launch type.

Example:

 import software.amazon.awscdk.services.cloudwatch.*;
 Cluster cluster;
 TaskDefinition taskDefinition;
 String serviceName = "MyFargateService";
 FargateService service = FargateService.Builder.create(this, "Service")
         .serviceName(serviceName)
         .cluster(cluster)
         .taskDefinition(taskDefinition)
         .minHealthyPercent(100)
         .build();
 Metric cpuMetric = Metric.Builder.create()
         .metricName("CPUUtilization")
         .namespace("AWS/ECS")
         .period(Duration.minutes(5))
         .statistic("Average")
         .dimensionsMap(Map.of(
                 "ClusterName", cluster.getClusterName(),
                 // Using `service.serviceName` here will cause a circular dependency
                 "ServiceName", serviceName))
         .build();
 Alarm myAlarm = Alarm.Builder.create(this, "CPUAlarm")
         .alarmName("cpuAlarmName")
         .metric(cpuMetric)
         .evaluationPeriods(2)
         .threshold(80)
         .build();
 service.enableDeploymentAlarms(List.of(myAlarm.getAlarmName()), DeploymentAlarmOptions.builder()
         .behavior(AlarmBehavior.FAIL_ON_ALARM)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	FargateServiceProps.Builder	A builder for FargateServiceProps
static final class	FargateServiceProps.Jsii$Proxy	An implementation for FargateServiceProps

Method Summary

Modifier and Type	Method	Description
static FargateServiceProps.Builder	builder()
default Boolean	getAssignPublicIp()	Specifies whether the task's elastic network interface receives a public IP address.
default AvailabilityZoneRebalancing	getAvailabilityZoneRebalancing()	Whether to use Availability Zone rebalancing for the service.
default FargatePlatformVersion	getPlatformVersion()	The platform version on which to run your service.
default List<ISecurityGroup>	getSecurityGroups()	The security groups to associate with the service.
TaskDefinition	getTaskDefinition()	The task definition to use for tasks in the service.
default SubnetSelection	getVpcSubnets()	The subnets to associate with the service.

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

getBakeTime, getCapacityProviderStrategies, getCircuitBreaker, getCloudMapOptions, getCluster, getDeploymentAlarms, getDeploymentController, getDeploymentStrategy, getDesiredCount, getEnableECSManagedTags, getEnableExecuteCommand, getHealthCheckGracePeriod, getLifecycleHooks, getMaxHealthyPercent, getMinHealthyPercent, getPropagateTags, getServiceConnectConfiguration, getServiceName, getTaskDefinitionRevision, getVolumeConfigurations

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getTaskDefinition

@Stability(Stable)
@NotNull
TaskDefinition getTaskDefinition()

The task definition to use for tasks in the service.

[disable-awslint:ref-via-interface]

getAssignPublicIp

@Stability(Stable)
@Nullable
default Boolean getAssignPublicIp()

Specifies whether the task's elastic network interface receives a public IP address.

If true, each task will receive a public IP address.

Default: false

getAvailabilityZoneRebalancing

@Stability(Stable)
@Nullable
default AvailabilityZoneRebalancing getAvailabilityZoneRebalancing()

Whether to use Availability Zone rebalancing for the service.

If enabled, maxHealthyPercent must be greater than 100, and the service must not be a target of a Classic Load Balancer.

Default: AvailabilityZoneRebalancing.ENABLED

See Also:

• https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html

getPlatformVersion

@Stability(Stable)
@Nullable
default FargatePlatformVersion getPlatformVersion()

The platform version on which to run your service.

If one is not specified, the LATEST platform version is used by default. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

Default: Latest

getSecurityGroups

@Stability(Stable)
@Nullable
default List<ISecurityGroup> getSecurityGroups()

The security groups to associate with the service.

If you do not specify a security group, a new security group is created.

Default: - A new security group is created.

getVpcSubnets

@Stability(Stable)
@Nullable
default SubnetSelection getVpcSubnets()

The subnets to associate with the service.

Default: - Public subnets if `assignPublicIp` is set, otherwise the first available one of Private, Isolated, Public, in that order.

builder

@Stability(Stable)
static FargateServiceProps.Builder builder()

Returns:

a FargateServiceProps.Builder of FargateServiceProps