Placement groups

To meet the needs of your workload, you can launch a group of interdependent EC2 instances into a placement group to influence their placement.

Depending on the type of workload, you can create a placement group using one of the following placement strategies:

• Cluster – Packs instances close together inside an Availability Zone. This strategy enables workloads to achieve the low-latency network performance necessary for tightly-coupled node-to-node communication that is typical of high-performance computing (HPC) applications.

• Partition – Spreads your instances across logical partitions such that groups of instances in one partition do not share the underlying hardware with groups of instances in different partitions. This strategy is typically used by large distributed and replicated workloads, such as Hadoop, Cassandra, and Kafka.

• Spread – Strictly places a small group of instances across distinct underlying hardware to reduce correlated failures.

Placement groups are optional. If you don't launch your instances into a placement group, EC2 tries to place the instances in such a way that all of your instances are spread out across the underlying hardware to minimize correlated failures.

There is no charge for creating a placement group.

Placement group strategies

You can create a placement group using one of the following placement strategies:

Cluster placement groups

A cluster placement group is a logical grouping of instances within a single Availability Zone. A cluster placement group can span peered virtual private networks (VPCs) in the same Region. Instances in the same cluster placement group enjoy a higher per-flow throughput limit for TCP/IP traffic and are placed in the same high-bisection bandwidth segment of the network.

The following image shows instances that are placed into a cluster placement group.

Cluster placement groups are recommended for applications that benefit from low network latency, high network throughput, or both. They are also recommended when the majority of the network traffic is between the instances in the group. To provide the lowest latency and the highest packet-per-second network performance for your placement group, choose an instance type that supports enhanced networking. For more information, see Enhanced Networking.

We recommend that you launch your instances in the following way:

• Use a single launch request to launch the number of instances that you need in the placement group.

• Use the same instance type for all instances in the placement group.

If you try to add more instances to the placement group later, or if you try to launch more than one instance type in the placement group, you increase your chances of getting an insufficient capacity error.

If you stop an instance in a placement group and then start it again, it still runs in the placement group. However, the start fails if there isn't enough capacity for the instance.

If you receive a capacity error when launching an instance in a placement group that already has running instances, stop and start all of the instances in the placement group, and try the launch again. Starting the instances may migrate them to hardware that has capacity for all of the requested instances.

Partition placement groups

Partition placement groups help reduce the likelihood of correlated hardware failures for your application. When using partition placement groups, Amazon EC2 divides each group into logical segments called partitions. Amazon EC2 ensures that each partition within a placement group has its own set of racks. Each rack has its own network and power source. No two partitions within a placement group share the same racks, allowing you to isolate the impact of hardware failure within your application.

The following image is a simple visual representation of a partition placement group in a single Availability Zone. It shows instances that are placed into a partition placement group with three partitions—Partition 1, Partition 2, and Partition 3. Each partition comprises multiple instances. The instances in a partition do not share racks with the instances in the other partitions, allowing you to contain the impact of a single hardware failure to only the associated partition.

Partition placement groups can be used to deploy large distributed and replicated workloads, such as HDFS, HBase, and Cassandra, across distinct racks. When you launch instances into a partition placement group, Amazon EC2 tries to distribute the instances evenly across the number of partitions that you specify. You can also launch instances into a specific partition to have more control over where the instances are placed.

A partition placement group can have partitions in multiple Availability Zones in the same Region. A partition placement group can have a maximum of seven partitions per Availability Zone. The number of instances that can be launched into a partition placement group is limited only by the limits of your account.

In addition, partition placement groups offer visibility into the partitions — you can see which instances are in which partitions. You can share this information with topology-aware applications, such as HDFS, HBase, and Cassandra. These applications use this information to make intelligent data replication decisions for increasing data availability and durability.

If you start or launch an instance in a partition 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.

Spread placement groups

A spread placement group is a group of instances that are each placed 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.

Rack spread level placement groups

The following image shows seven instances in a single Availability Zone that are placed into a spread placement group. The seven instances are placed on seven different racks, each rack has its own network and power source.

A rack spread placement group can span multiple Availability Zones in the same Region. For rack spread level placement groups, you can have a maximum of seven running instances per Availability Zone per group.

Host level spread placement groups

Host spread level placement groups are only available with AWS Outposts. For host spread level placement groups, there are no restrictions for running instances per Outposts. For more information, see Placement groups on AWS Outposts.

Placement group rules and limitations

General rules and limitations

Before you use placement groups, be aware of the following rules:

• You can create a maximum of 500 placement groups per account in each Region.

• The name that you specify for a placement group must be unique within your AWS account for the Region.

• You can't merge placement groups.

• An instance can be launched in one placement group at a time; it cannot span multiple placement groups.

• On-Demand Capacity Reservation and zonal Reserved Instances provide a capacity reservation for EC2 instances in a specific Availability Zone. The capacity reservation can be used by instances in a placement group. When using a cluster placement group with capacity reservation, it is recommended that you reserve capacity within the cluster placement group. For more information, see Capacity Reservations in cluster placement groups.

  Zonal Reserved Instances provide a capacity reservation for instances in a specific Availability Zone. The capacity reservation can be used by instances in a placement group. However, it is not possible to explicitly reserve capacity in a placement group using a zonal Reserved Instance.

• You can't launch Dedicated Hosts in placement groups.

• You can't launch a Spot Instance that is configured to stop or hibernate on interruption in a placement group.

Cluster placement group rules and limitations

The following rules apply to cluster placement groups:

• The following instance types are supported:

  • Current generation instances, except for burstable performance instances (for example, T2), Mac1 instances, and M7i-flex instances.

  • The following previous generation instances: A1, C3, C4, G2, I2, M4, R3, and R4.

• A cluster placement group can't span multiple Availability Zones.

• The maximum network throughput speed of traffic between two instances in a cluster placement group is limited by the slower of the two instances. For applications with high-throughput requirements, choose an instance type with network connectivity that meets your requirements.

• For instances that are enabled for enhanced networking, the following rules apply:

  • Instances within a cluster placement group can use up to 10 Gbps for single-flow traffic. Instances that are not within a cluster placement group can use up to 5 Gbps for single-flow traffic.

  • Traffic to and from Amazon S3 buckets within the same Region over the public IP address space or through a VPC endpoint can use all available instance aggregate bandwidth.

• You can launch multiple instance types into a cluster placement group. However, this reduces the likelihood that the required capacity will be available for your launch to succeed. We recommend using the same instance type for all instances in a cluster placement group.

• Network traffic to the internet and over an AWS Direct Connect connection to on-premises resources is limited to 5 Gbps.

Partition placement group rules and limitations

The following rules apply to partition placement groups:

• A partition placement group supports a maximum of seven partitions per Availability Zone. The number of instances that you can launch in a partition placement group is limited only by your account limits.

• When instances are launched into a partition placement group, Amazon EC2 tries to evenly distribute the instances across all partitions. Amazon EC2 doesn’t guarantee an even distribution of instances across all partitions.

• A partition placement group with Dedicated Instances can have a maximum of two partitions.

• Capacity Reservations do not reserve capacity in a partition placement group.

Spread placement group rules and limitations

The following rules apply to spread placement groups:

• A rack spread placement group supports a maximum of seven running instances per Availability Zone. For example, in a Region with three Availability Zones, you can run a total of 21 instances in the group, with seven instances in each Availability Zone. If you try to start an eighth instance in the same Availability Zone and in the same spread placement group, the instance will not launch. If you need more than seven instances in an Availability Zone, we recommend that you use multiple spread placement groups. Using multiple spread placement groups does not provide guarantees about the spread of instances between groups, but it does help ensure the spread for each group, thus limiting the impact from certain classes of failures.

• Spread placement groups are not supported for Dedicated Instances.

• Host level spread placement groups are only supported for placement groups on AWS Outposts. There are no restrictions for the number of running instances with host level spread placement groups.

• Capacity Reservations do not reserve capacity in a spread placement group.

Working with placement groups

Contents

• Create a placement group
• Tag a placement group
• Launch instances in a placement group
• Describe instances in a placement group
• Change the placement group for an instance
• Delete a placement group

Create a placement group

You can create a placement group using one of the following methods.

Note

You can tag a placement group on creation using the command line tools only.

Console

To create a placement group using the console

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. In the navigation pane, choose Placement Groups, Create placement group.

3. Specify a name for the group.

4. Choose the placement strategy for the group. If you choose Partition, choose the number of partitions within the group.

   Choose the placement strategy for the group.

   • If you choose Spread, choose the spread level.

     • Rack - no restrictions

     • Host - only for Outposts

   • If you choose Partition, choose the number of partitions within the group.

5. To tag the placement group, choose Add tag, and then enter a key and value. Choose Add tag for each tag that you want to add.

6. Choose Create group.

AWS CLI

To create a placement group using the AWS CLI

Use the create-placement-group command. The following example creates a placement group named my-cluster that uses the cluster placement strategy, and it applies a tag with a key of purpose and a value of production.

aws ec2 create-placement-group --group-name my-cluster --strategy cluster --tag-specifications 'ResourceType=placement-group,Tags={Key=purpose,Value=production}'

To create a partition placement group using the AWS CLI

Use the create-placement-group command. Specify the --strategy parameter with the value partition, and specify the --partition-count parameter with the desired number of partitions. In this example, the partition placement group is named HDFS-Group-A and is created with five partitions.

aws ec2 create-placement-group --group-name HDFS-Group-A --strategy partition --partition-count 5

PowerShell

To create a placement group using the AWS Tools for Windows PowerShell

Use the New-EC2PlacementGroup command.

Tag a placement group

To help categorize and manage your existing placement groups, you can tag them with custom metadata. For more information about how tags work, see Tag your Amazon EC2 resources.

When you tag a placement group, the instances that are launched into the placement group are not automatically tagged. You need to explicitly tag the instances that are launched into the placement group. For more information, see Add a tag when you launch an instance.

You can view, add, and delete tags using the new console and the command line tools.

New console

You can view, add, and delete tags using one of the following methods.

Console

To view, add, or delete a tag for an existing placement group

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

3. In the navigation pane, choose Placement Groups.

4. Select a placement group, and then choose Actions, Manage tags.

5. The Manage tags section displays any tags that are assigned to the placement group. Do the following to add or remove tags:

   • To add a tag, choose Add tag, and then enter the tag key and value. You can add up to 50 tags per placement group. For more information, see Tag restrictions.

   • To delete a tag, choose Remove next to the tag that you want to delete.

6. Choose Save changes.

AWS CLI

To view placement group tags

Use the describe-tags command to view the tags for the specified resource. In the following example, you describe the tags for all of your placement groups.

aws ec2 describe-tags \
    --filters Name=resource-type,Values=placement-group			

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        },
        {
            "Key": "Environment",
            "ResourceId": "pg-9876543210EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}		

You can also use the describe-tags command to view the tags for a placement group by specifying its ID. In the following example, you describe the tags for pg-0123456789EXAMPLE.

aws ec2 describe-tags \

    --filters Name=resource-id,Values=pg-0123456789EXAMPLE

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}

You can also view the tags of a placement group by describing the placement group.

Use the describe-placement-groups command to view the configuration of the specified placement group, which includes any tags that were specified for the placement group.

aws ec2 describe-placement-groups \
    --group-name my-cluster

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789EXAMPLE",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}			

To tag an existing placement group using the AWS CLI

You can use the create-tags command to tag existing resources. In the following example, the existing placement group is tagged with Key=Cost-Center and Value=CC-123.

aws ec2 create-tags \
    --resources pg-0123456789EXAMPLE \
    --tags Key=Cost-Center,Value=CC-123

To delete a tag from a placement group using the AWS CLI

You can use the delete-tags command to delete tags from existing resources. For examples, see Examples in the AWS CLI Command Reference.

PowerShell

To view placement group tags

Use the Get-EC2Tag command.

To describe the tags for a specific placement group

Use the Get-EC2PlacementGroup command.

To tag an existing placement group

Use the New-EC2Tag command.

To delete a tag from a placement group

Use the Remove-EC2Tag command.

Launch instances in a placement group

You can launch an instance into a placement group if the placement group rules and limitations are met using one of the following methods.

Console

To launch instances into a placement group using the console

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. From the EC2 console dashboard, in the Launch instance box, choose Launch instance. Complete the form as directed, taking care to do the following:

   • Under Instance type, select an instance type that can be launched into a placement group.

   • In the Summary box, under Number of instances, enter the total number of instances that you need in this placement group, because you might not be able to add instances to the placement group later.

   • Under Advanced details, for Placement group name, you can choose to add the instances to a new or existing placement group. If you choose a placement group with a partition strategy, for Target partition, choose the partition in which to launch the instances.

Old Console

To launch instances into a placement group using the console

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. In the navigation pane, choose Instances.

3. Choose Launch Instance. Complete the wizard as directed, taking care to do the following:

   From the EC2 console dashboard, in the Launch instance box, choose Launch instance. Complete the wizard as directed, taking care to do the following:

   • On the Choose an Instance Type page, select an instance type that can be launched into a placement group.

   • On the Configure Instance Details page, the following fields are applicable to placement groups:

     • For Number of instances, enter the total number of instances that you need in this placement group, because you might not be able to add instances to the placement group later.

     • For Placement group, select the Add instance to placement group check box. If you do not see Placement group on this page, verify that you have selected an instance type that can be launched into a placement group. Otherwise, this option is not available.

     • For Placement group name, you can choose to add the instances to an existing placement group or to a new placement group that you create.

     • For Placement group strategy, choose the appropriate strategy. If you choose partition, for Target partition, choose Auto distribution to have Amazon EC2 do a best effort to distribute the instances evenly across all the partitions in the group. Alternatively, specify the partition in which to launch the instances.

AWS CLI

To launch instances into a placement group using the AWS CLI

Use the run-instances command and specify the placement group name using the --placement "GroupName = my-cluster" parameter. In this example, the placement group is named my-cluster.

aws ec2 run-instances --placement "GroupName = my-cluster"

To launch instances into a specific partition of a partition placement group using the AWS CLI

Use the run-instances command and specify the placement group name and partition using the --placement "GroupName = HDFS-Group-A, PartitionNumber = 3" parameter. In this example, the placement group is named HDFS-Group-A and the partition number is 3.

aws ec2 run-instances --placement "GroupName = HDFS-Group-A, PartitionNumber = 3"

PowerShell

To launch instances into a placement group using AWS Tools for Windows PowerShell

Use the New-EC2Instance command and specify the placement group name using the -Placement_GroupName parameter.

Describe instances in a placement group

You can view the placement information of your instances using one of the following methods. You can also filter partition placement groups by the partition number using the AWS CLI.

Console

To view the placement group and partition number of an instance using the console

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. In the navigation pane, choose Instances.

3. Select the instance.

4. On the Details tab, under Host and placement group, find Placement group. If the instance is not in a placement group, the field is empty. Otherwise, it contains the name of the placement group name. If the placement group is a partition placement group, Partition number contains the partition number for the instance.

AWS CLI

To view the partition number for an instance in a partition placement group using the AWS CLI

Use the describe-instances command and specify the --instance-id parameter.

aws ec2 describe-instances --instance-id i-0123a456700123456

The response contains the placement information, which includes the placement group name and the partition number for the instance.

"Placement": {
     "AvailabilityZone": "us-east-1c",
     "GroupName": "HDFS-Group-A",
     "PartitionNumber": 3,
     "Tenancy": "default"
}

To filter instances for a specific partition placement group and partition number using the AWS CLI

Use the describe-instances command and specify the --filters parameter with the placement-group-name and placement-partition-number filters. In this example, the placement group is named HDFS-Group-A and the partition number is 7.

aws ec2 describe-instances --filters "Name = placement-group-name, Values = HDFS-Group-A" "Name = placement-partition-number, Values = 7"

The response lists all the instances that are in the specified partition within the specified placement group. The following is example output showing only the instance ID, instance type, and placement information for the returned instances.

"Instances": [
                {   
                    "InstanceId": "i-0a1bc23d4567e8f90",
                    "InstanceType": "r4.large",
                    },
                  
                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }

                {   
                    "InstanceId": "i-0a9b876cd5d4ef321",
                    "InstanceType": "r4.large",
                    },

                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }
              ],      

Change the placement group for an instance

You can change the placement group for an instance in any of the following ways:

• Move an existing instance to a placement group

• Move an instance from one placement group to another

• Remove an instance from a placement group

Before you move or remove the instance, the instance must be in the stopped state. You can move or remove an instance using the AWS CLI or an AWS SDK.

AWS CLI

To move an instance to a placement group using the AWS CLI

1. Stop the instance using the stop-instances command.

2. Use the modify-instance-placement command and specify the name of the placement group to which to move the instance.

   aws ec2 modify-instance-placement --instance-id i-0123a456700123456 --group-name MySpreadGroup

3. Start the instance using the start-instances command.

PowerShell

To move an instance to a placement group using the AWS Tools for Windows PowerShell

1. Stop the instance using the Stop-EC2Instance command.

2. Use the Edit-EC2InstancePlacement command and specify the name of the placement group to which to move the instance.

3. Start the instance using the Start-EC2Instance command.

 

AWS CLI

To remove an instance from a placement group using the AWS CLI

1. Stop the instance using the stop-instances command.

2. Use the modify-instance-placement command and specify an empty string for the placement group name.

   aws ec2 modify-instance-placement --instance-id i-0123a456700123456 --group-name ""

3. Start the instance using the start-instances command.

PowerShell

To remove an instance from a placement group using the AWS Tools for Windows PowerShell

1. Stop the instance using the Stop-EC2Instance command.

2. Use the Edit-EC2InstancePlacement command and specify an empty string for the placement group name.

3. Start the instance using the Start-EC2Instance command.

Delete a placement group

If you need to replace a placement group or no longer need one, you can delete it. You can delete a placement group using one of the following methods.

Requirement

Before you can delete a placement group, it must contain no instances. You can terminate all instances that you launched in the placement group, moveinstances to another placement group, or remove instances from the placement group.

Console

To delete a placement group using the console

1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

2. In the navigation pane, choose Placement Groups.

3. Select the placement group and choose Actions, Delete.

4. When prompted for confirmation, enter Delete and then choose Delete.

AWS CLI

To delete a placement group using the AWS CLI

Use the delete-placement-group command and specify the placement group name to delete the placement group. In this example, the placement group name is my-cluster.

aws ec2 delete-placement-group --group-name my-cluster

PowerShell

To delete a placement group using the AWS Tools for Windows PowerShell

Use the Remove-EC2PlacementGroup command to delete the placement group.