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.119.0 (build 1634eac)", date="2025-12-01T16:02:19.413Z") @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:

  • 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

    • getNode

      @Stability(Stable) @NotNull software.constructs.Node getNode()
      The tree node.
      Specified by:
      getNode in interface software.constructs.IConstruct

    • getEnv

      @Stability(Stable) @NotNull ResourceEnvironment getEnv()
      The environment this resource belongs to.

      For resources that are created and managed in a Stack (those created by creating new class instances like new Role(), new Bucket(), etc.), this is always the same as the environment of the stack they belong to.

      For referenced resources (those obtained from referencing methods like Role.fromRoleArn(), Bucket.fromBucketName(), etc.), they might be different than the stack they were imported into.

      Specified by:
      getEnv in interface IEnvironmentAware