Package software.amazon.awscdk.services.ec2

Interface IPlacementGroup

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IDependable, IEnvironmentAware, IPlacementGroupRef, IResource, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

IPlacementGroup.Jsii$Default

All Known Implementing Classes:

IPlacementGroup.Jsii$Proxy, PlacementGroup

@Generated(value="jsii-pacmak/1.125.0 (build fdbe357)",
           date="2026-01-19T12:03:53.319Z")
@Stability(Stable)
public interface IPlacementGroup
extends software.amazon.jsii.JsiiSerializable, IResource, IPlacementGroupRef

Determines where your instances are placed on the underlying hardware according to the specified PlacementGroupStrategy.

See Also:

• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	IPlacementGroup.Jsii$Default	Internal default implementation for IPlacementGroup.
static final class	IPlacementGroup.Jsii$Proxy	A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method	Description
default Number	getPartitions()	The number of partitions.
String	getPlacementGroupName()	The name of this placement group.
default PlacementGroupSpreadLevel	getSpreadLevel()	Places instances on distinct hardware.
default PlacementGroupStrategy	getStrategy()	Which strategy to use when launching instances.

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.awscdk.interfaces.ec2.IPlacementGroupRef

getPlacementGroupRef

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getPlacementGroupName

@Stability(Stable)
@NotNull
String getPlacementGroupName()

The name of this placement group.

getPartitions

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

The number of partitions.

Valid only when Strategy is set to PARTITION.

Default: 0

getSpreadLevel

@Stability(Stable)
@Nullable
default PlacementGroupSpreadLevel getSpreadLevel()

Places instances on distinct hardware.

Spread placement groups are recommended for applications that have a small number of critical instances that should be kept separate from each other. Launching instances in a spread level placement group reduces the risk of simultaneous failures that might occur when instances share the same equipment. Spread level placement groups provide access to distinct hardware, and are therefore suitable for mixing instance types or launching instances over time. If you start or launch an instance in a spread placement group and there is insufficient unique hardware to fulfill the request, the request fails. Amazon EC2 makes more distinct hardware available over time, so you can try your request again later. Placement groups can spread instances across racks or hosts. You can use host level spread placement groups only with AWS Outposts.

Default: - no spread level

getStrategy

@Stability(Stable)
@Nullable
default PlacementGroupStrategy getStrategy()

Which strategy to use when launching instances.

Default: - `PlacementGroupStrategy.PARTITION` if `partitions` is defined, `CLUSTER` otherwise