class Aws::AutoScaling::Types::RefreshPreferences

Describes the preferences for an instance refresh.

@note When making an API call, you may pass RefreshPreferences

data as a hash:

    {
      min_healthy_percentage: 1,
      instance_warmup: 1,
      checkpoint_percentages: [1],
      checkpoint_delay: 1,
      skip_matching: false,
    }

@!attribute [rw] min_healthy_percentage

The amount of capacity in the Auto Scaling group that must remain
healthy during an instance refresh to allow the operation to
continue. The value is expressed as a percentage of the desired
capacity of the Auto Scaling group (rounded up to the nearest
integer). The default is `90`.

Setting the minimum healthy percentage to 100 percent limits the
rate of replacement to one instance at a time. In contrast, setting
it to 0 percent has the effect of replacing all instances at the
same time.
@return [Integer]

@!attribute [rw] instance_warmup

The number of seconds until a newly launched instance is configured
and ready to use. During this time, Amazon EC2 Auto Scaling does not
immediately move on to the next replacement. The default is to use
the value for the health check grace period defined for the group.
@return [Integer]

@!attribute [rw] checkpoint_percentages

Threshold values for each checkpoint in ascending order. Each number
must be unique. To replace all instances in the Auto Scaling group,
the last number in the array must be `100`.

For usage examples, see [Adding checkpoints to an instance
refresh][1] in the *Amazon EC2 Auto Scaling User Guide*.

[1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-adding-checkpoints-instance-refresh.html
@return [Array<Integer>]

@!attribute [rw] checkpoint_delay

The amount of time, in seconds, to wait after a checkpoint before
continuing. This property is optional, but if you specify a value
for it, you must also specify a value for `CheckpointPercentages`.
If you specify a value for `CheckpointPercentages` and not for
`CheckpointDelay`, the `CheckpointDelay` defaults to `3600` (1
hour).
@return [Integer]

@!attribute [rw] skip_matching

A boolean value that indicates whether skip matching is enabled. If
true, then Amazon EC2 Auto Scaling skips replacing instances that
match the desired configuration. If no desired configuration is
specified, then it skips replacing instances that have the same
configuration that is already set on the group. The default is
`false`.
@return [Boolean]

@see docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RefreshPreferences AWS API Documentation

Constants

SENSITIVE