Package software.amazon.awscdk.services.ecs

Interface Ec2ServiceProps

All Superinterfaces:

BaseServiceOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

Ec2ServiceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:09.697Z")
@Stability(Stable)
public interface Ec2ServiceProps
extends software.amazon.jsii.JsiiSerializable, BaseServiceOptions

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

Example:

 Vpc vpc;
 // Create an ECS cluster
 Cluster cluster = Cluster.Builder.create(this, "Cluster").vpc(vpc).build();
 // Add capacity to it
 cluster.addCapacity("DefaultAutoScalingGroupCapacity", AddCapacityOptions.builder()
         .instanceType(new InstanceType("t2.xlarge"))
         .desiredCapacity(3)
         .build());
 Ec2TaskDefinition taskDefinition = new Ec2TaskDefinition(this, "TaskDef");
 taskDefinition.addContainer("DefaultContainer", ContainerDefinitionOptions.builder()
         .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
         .memoryLimitMiB(512)
         .build());
 // Instantiate an Amazon ECS Service
 Ec2Service ecsService = Ec2Service.Builder.create(this, "Service")
         .cluster(cluster)
         .taskDefinition(taskDefinition)
         .minHealthyPercent(100)
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static Ec2ServiceProps.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 Boolean	getDaemon()	Specifies whether the service will use the daemon scheduling strategy.
default List<PlacementConstraint>	getPlacementConstraints()	The placement constraints to use for tasks in the service.
default List<PlacementStrategy>	getPlacementStrategies()	The placement strategies to use for tasks in the 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.

This property is only used for tasks that use the awsvpc network mode.

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; daemon must be false; if there are any placementStrategies, the first must be "spread across Availability Zones"; there must be no placementConstraints using attribute:ecs.availability-zone, 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

getDaemon

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

Specifies whether the service will use the daemon scheduling strategy.

If true, the service scheduler deploys exactly one task on each container instance in your cluster.

When you are using this strategy, do not specify a desired number of tasks or any task placement strategies.

Default: false

getPlacementConstraints

@Stability(Stable)
@Nullable
default List<PlacementConstraint> getPlacementConstraints()

The placement constraints to use for tasks in the service.

For more information, see Amazon ECS Task Placement Constraints.

Default: - No constraints.

getPlacementStrategies

@Stability(Stable)
@Nullable
default List<PlacementStrategy> getPlacementStrategies()

The placement strategies to use for tasks in the service.

For more information, see Amazon ECS Task Placement Strategies.

Default: - No strategies.

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.

This property is only used for tasks that use the awsvpc network mode.

Default: - A new security group is created.

getVpcSubnets

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

The subnets to associate with the service.

This property is only used for tasks that use the awsvpc network mode.

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

builder

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

Returns:

a Ec2ServiceProps.Builder of Ec2ServiceProps