Package software.amazon.awscdk.services.ecs.patterns

Interface ApplicationLoadBalancedFargateServiceProps

All Superinterfaces:

ApplicationLoadBalancedServiceBaseProps, FargateServiceBaseProps, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ApplicationLoadBalancedFargateServiceProps.Jsii$Proxy

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

The properties for the ApplicationLoadBalancedFargateService service.

Example:

 Cluster cluster;
 ApplicationLoadBalancedFargateService loadBalancedFargateService = ApplicationLoadBalancedFargateService.Builder.create(this, "Service")
         .cluster(cluster)
         .memoryLimitMiB(1024)
         .desiredCount(1)
         .cpu(512)
         .taskImageOptions(ApplicationLoadBalancedTaskImageOptions.builder()
                 .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
                 .build())
         .minHealthyPercent(100)
         .build();
 ScalableTaskCount scalableTarget = loadBalancedFargateService.service.autoScaleTaskCount(EnableScalingProps.builder()
         .minCapacity(1)
         .maxCapacity(20)
         .build());
 scalableTarget.scaleOnCpuUtilization("CpuScaling", CpuUtilizationScalingProps.builder()
         .targetUtilizationPercent(50)
         .build());
 scalableTarget.scaleOnMemoryUtilization("MemoryScaling", MemoryUtilizationScalingProps.builder()
         .targetUtilizationPercent(50)
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static ApplicationLoadBalancedFargateServiceProps.Builder	builder()
default Boolean	getAssignPublicIp()	Determines whether the service will be assigned a public IP address.
default Number	getContainerCpu()	The minimum number of CPU units to reserve for the container.
default Number	getContainerMemoryLimitMiB()	The amount (in MiB) of memory to present to the container.
default HealthCheck	getHealthCheck()	The health check command and associated configuration parameters for the container.
default List<ISecurityGroup>	getSecurityGroups()	The security groups to associate with the service.
default SubnetSelection	getTaskSubnets()	The subnets to associate with the service.

Methods inherited from interface software.amazon.awscdk.services.ecs.patterns.ApplicationLoadBalancedServiceBaseProps

getCapacityProviderStrategies, getCertificate, getCircuitBreaker, getCloudMapOptions, getCluster, getDeploymentController, getDesiredCount, getDomainName, getDomainZone, getEnableECSManagedTags, getEnableExecuteCommand, getHealthCheckGracePeriod, getIdleTimeout, getIpAddressType, getListenerPort, getLoadBalancer, getLoadBalancerName, getMaxHealthyPercent, getMinHealthyPercent, getOpenListener, getPropagateTags, getProtocol, getProtocolVersion, getPublicLoadBalancer, getRecordType, getRedirectHTTP, getServiceName, getSslPolicy, getTargetProtocol, getTaskImageOptions, getVpc

Methods inherited from interface software.amazon.awscdk.services.ecs.patterns.FargateServiceBaseProps

getCpu, getEphemeralStorageGiB, getMemoryLimitMiB, getPlatformVersion, getRuntimePlatform, getTaskDefinition

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAssignPublicIp

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

Determines whether the service will be assigned a public IP address.

Default: false

getContainerCpu

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

The minimum number of CPU units to reserve for the container.

Default: - No minimum CPU units reserved.

getContainerMemoryLimitMiB

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

The amount (in MiB) of memory to present to the container.

If your container attempts to exceed the allocated memory, the container is terminated.

Default: - No memory limit.

getHealthCheck

@Stability(Stable)
@Nullable
default HealthCheck getHealthCheck()

The health check command and associated configuration parameters for the container.

Default: - Health check configuration from container.

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.

getTaskSubnets

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

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 ApplicationLoadBalancedFargateServiceProps.Builder builder()

Returns:

a ApplicationLoadBalancedFargateServiceProps.Builder of ApplicationLoadBalancedFargateServiceProps