class Aws::AutoScaling::Types::StartInstanceRefreshType

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

data as a hash:

    {
      auto_scaling_group_name: "XmlStringMaxLen255", # required
      strategy: "Rolling", # accepts Rolling
      desired_configuration: {
        launch_template: {
          launch_template_id: "XmlStringMaxLen255",
          launch_template_name: "LaunchTemplateName",
          version: "XmlStringMaxLen255",
        },
        mixed_instances_policy: {
          launch_template: {
            launch_template_specification: {
              launch_template_id: "XmlStringMaxLen255",
              launch_template_name: "LaunchTemplateName",
              version: "XmlStringMaxLen255",
            },
            overrides: [
              {
                instance_type: "XmlStringMaxLen255",
                weighted_capacity: "XmlStringMaxLen32",
                launch_template_specification: {
                  launch_template_id: "XmlStringMaxLen255",
                  launch_template_name: "LaunchTemplateName",
                  version: "XmlStringMaxLen255",
                },
              },
            ],
          },
          instances_distribution: {
            on_demand_allocation_strategy: "XmlString",
            on_demand_base_capacity: 1,
            on_demand_percentage_above_base_capacity: 1,
            spot_allocation_strategy: "XmlString",
            spot_instance_pools: 1,
            spot_max_price: "MixedInstanceSpotPrice",
          },
        },
      },
      preferences: {
        min_healthy_percentage: 1,
        instance_warmup: 1,
        checkpoint_percentages: [1],
        checkpoint_delay: 1,
        skip_matching: false,
      },
    }

@!attribute [rw] auto_scaling_group_name

The name of the Auto Scaling group.
@return [String]

@!attribute [rw] strategy

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

A rolling update helps you update your instances gradually. 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 are replaced are not rolled back
to their previous configuration.
@return [String]

@!attribute [rw] desired_configuration

The desired configuration. For example, the desired configuration
can specify a new launch template or a new version of the current
launch template.

Once the instance refresh succeeds, Amazon EC2 Auto Scaling updates
the settings of the Auto Scaling group to reflect the new desired
configuration.

<note markdown="1"> When you specify a new launch template or a new version of the
current launch template for your desired configuration, consider
enabling the `SkipMatching` property in preferences. If it's
enabled, Amazon EC2 Auto Scaling skips replacing instances that
already use the specified launch template and version. This can help
you reduce the number of replacements that are required to apply
updates.

 </note>
@return [Types::DesiredConfiguration]

@!attribute [rw] preferences

Set of preferences associated with the instance refresh request. If
not provided, the default values are used.
@return [Types::RefreshPreferences]

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

Constants

SENSITIVE