NAME

Paws::AutoScaling::StartInstanceRefresh - Arguments for method StartInstanceRefresh on Paws::AutoScaling

DESCRIPTION

This class represents the parameters used for calling the method StartInstanceRefresh on the Auto Scaling service. Use the attributes of this class as arguments to method StartInstanceRefresh.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to StartInstanceRefresh.

SYNOPSIS

    my $autoscaling = Paws->service('AutoScaling');
 # To start an instance refresh
 # This example starts an instance refresh for the specified Auto Scaling group.
    my $StartInstanceRefreshAnswer = $autoscaling->StartInstanceRefresh(
      'AutoScalingGroupName' => 'my-auto-scaling-group',
      'Preferences'          => {
        'InstanceWarmup'       => 400,
        'MinHealthyPercentage' => 50
      }
    );
    # Results:
    my $InstanceRefreshId = $StartInstanceRefreshAnswer->InstanceRefreshId;
    # Returns a L<Paws::AutoScaling::StartInstanceRefreshAnswer> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/autoscaling/StartInstanceRefresh>

ATTRIBUTES

REQUIRED AutoScalingGroupName => Str

The name of the Auto Scaling group.

Preferences => Paws::AutoScaling::RefreshPreferences

Set of preferences associated with the instance refresh request.

If not provided, the default values are used. For "MinHealthyPercentage", the default value is 90. For "InstanceWarmup", the default is to use the value specified for the health check grace period for the Auto Scaling group.

For more information, see RefreshPreferences (https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_RefreshPreferences.html) in the Amazon EC2 Auto Scaling API Reference.

Strategy => Str

The strategy to use for the instance refresh. The only valid value is "Rolling".

A rolling update is an update that is applied to all instances in an Auto Scaling group until all instances have been updated. A rolling update can fail due to failed health checks or if instances are on standby or are protected from scale in. If the rolling update process fails, any instances that were already replaced are not rolled back to their previous configuration.

Valid values are: "Rolling"

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>