Examples for creating and managing warm pools with the Amazon CLI - Amazon EC2 Auto Scaling
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Examples for creating and managing warm pools with the Amazon CLI

You can create and manage warm pools using the Amazon Web Services Management Console, Amazon Command Line Interface (Amazon CLI), or SDKs.

The following examples show you how to create and manage warm pools using the Amazon CLI.

Example 1: Keep instances in the Stopped state

The following put-warm-pool example creates a warm pool that keeps instances in a Stopped state.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped

Example 2: Keep instances in the Running state

The following put-warm-pool example creates a warm pool that keeps instances in a Running state instead of a Stopped state.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Running

Example 3: Keep instances in the Hibernated state

The following put-warm-pool example creates a warm pool that keeps instances in a Hibernated state instead of a Stopped state. This lets you stop instances without deleting their memory contents (RAM).

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Hibernated

Example 4: Return instances to the warm pool when scaling in

The following put-warm-pool example creates a warm pool that keeps instances in a Stopped state and includes the --instance-reuse-policy option. The instance reuse policy value '{"ReuseOnScaleIn": true}' tells Amazon EC2 Auto Scaling to return instances to the warm pool when your Auto Scaling group scales in.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped --instance-reuse-policy '{"ReuseOnScaleIn": true}'

Example 5: Specify the minimum number of instances in the warm pool

The following put-warm-pool example creates a warm pool that maintains a minimum of 4 instances, so that there are at least 4 instances available to handle traffic spikes.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped --min-size 4

Example 6: Define the warm pool maximum capacity separately

Generally, you understand how much to increase your maximum capacity above your desired capacity. There's usually no need to define an additional maximum size, because Amazon EC2 Auto Scaling creates a warm pool that dynamically resizes based on your group's desired and maximum capacity. However, you can use the --max-group-prepared-capacity option to define the warm pool maximum capacity separately when desired.

The following put-warm-pool example creates a warm pool that defines its maximum capacity separately. Suppose that the Auto Scaling group has a desired capacity of 800. The size of the warm pool will be 100 when you run this command and the pool is initializing.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped --max-group-prepared-capacity 900

To maintain a minimum number of instances in the warm pool, include the --min-size option with the command, as follows.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped --max-group-prepared-capacity 900 --min-size 25

Example 7: Define an absolute warm pool size

If you set the same values for the --max-group-prepared-capacity and --min-size options, the warm pool has an absolute size. The following put-warm-pool example creates a warm pool that maintains a constant warm pool size of 10 instances.

aws autoscaling put-warm-pool --auto-scaling-group-name my-asg / --pool-state Stopped --min-size 10 --max-group-prepared-capacity 10

Example 8: Delete a warm pool

Use the following delete-warm-pool command to delete a warm pool.

aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg

If there are instances in the warm pool, or if scaling activities are in progress, use the delete-warm-pool command with the --force-delete option. This option also terminates the Amazon EC2 instances and any outstanding lifecycle actions.

aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg --force-delete