Struct aws_sdk_autoscaling::operation::start_instance_refresh::StartInstanceRefreshInput

#[non_exhaustive]
pub struct StartInstanceRefreshInput {
    pub auto_scaling_group_name: Option<String>,
    pub strategy: Option<RefreshStrategy>,
    pub desired_configuration: Option<DesiredConfiguration>,
    pub preferences: Option<RefreshPreferences>,
}

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

auto_scaling_group_name: Option<String>

The name of the Auto Scaling group.

strategy: Option<RefreshStrategy>

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

desired_configuration: Option<DesiredConfiguration>

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.

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 instance types. This can help you reduce the number of replacements that are required to apply updates.

preferences: Option<RefreshPreferences>

Sets your preferences for the instance refresh so that it performs as expected when you start it. Includes the instance warmup time, the minimum healthy percentage, and the behaviors that you want Amazon EC2 Auto Scaling to use if instances that are in Standby state or protected from scale in are found. You can also choose to enable additional features, such as the following:

• Auto rollback

• Checkpoints

• CloudWatch alarms

• Skip matching

Implementations

impl StartInstanceRefreshInput

pub fn auto_scaling_group_name(&self) -> Option<&str>

The name of the Auto Scaling group.

pub fn strategy(&self) -> Option<&RefreshStrategy>

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

pub fn desired_configuration(&self) -> Option<&DesiredConfiguration>

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.

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 instance types. This can help you reduce the number of replacements that are required to apply updates.

pub fn preferences(&self) -> Option<&RefreshPreferences>

Sets your preferences for the instance refresh so that it performs as expected when you start it. Includes the instance warmup time, the minimum healthy percentage, and the behaviors that you want Amazon EC2 Auto Scaling to use if instances that are in Standby state or protected from scale in are found. You can also choose to enable additional features, such as the following:

• Auto rollback

• Checkpoints

• CloudWatch alarms

• Skip matching

impl StartInstanceRefreshInput

pub fn builder() -> StartInstanceRefreshInputBuilder

Creates a new builder-style object to manufacture StartInstanceRefreshInput.

Trait Implementations

impl Clone for StartInstanceRefreshInput

fn clone(&self) -> StartInstanceRefreshInput

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StartInstanceRefreshInput

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for StartInstanceRefreshInput

fn eq(&self, other: &StartInstanceRefreshInput) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StartInstanceRefreshInput