aws-cdk-lib.aws_autoscaling.InstanceRefreshStrategy

InstanceRefreshStrategy Enum

The strategy to use for the instance refresh.

Source

aws-autoscaling/lib/auto-scaling-group.ts

Type last changed

v2.263.0 · 31 Jul 2026

Example

declare const vpc: ec2.Vpc;
declare const instanceType: ec2.InstanceType;
declare const machineImage: ec2.IMachineImage;
declare const alarm: cloudwatch.Alarm;

new autoscaling.AutoScalingGroup(this, 'ASG', {
  vpc,
  instanceType,
  machineImage,

  updatePolicy: autoscaling.UpdatePolicy.instanceRefresh({
    strategy: autoscaling.InstanceRefreshStrategy.ROLLING,
    minHealthyPercentage: 90,
    maxHealthyPercentage: 100,
    instanceWarmup: Duration.seconds(300),
    checkpointPercentages: [50, 100],
    checkpointDelay: Duration.minutes(10),
    alarms: [alarm],
  }),
});

Members

Member	Description
ROLLING	Terminate instances and launch new ones to replace them.
REPLACE_ROOT_VOLUME	Replace the root volume of instances in place.

Referenced by

• InstanceRefreshOptions.strategystrategystrategyStrategyStrategy